claude agents: --mcp-config, --settings, --plugin-dir, --add-dir flags rejected despite changelog entry in 2.1.142

Resolved 💬 4 comments Opened May 15, 2026 by gabe4coding Closed May 15, 2026

Description

The 2.1.142 changelog states:

Added new claude agents flags: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, and --dangerously-skip-permissions to configure dispatched background sessions

However, all four profile-configuration flags (--mcp-config, --settings, --plugin-dir, --add-dir) are rejected with error: unknown option at launch.

Steps to reproduce

$ claude --version
2.1.142 (Claude Code)

$ claude agents --mcp-config /dev/null
error: unknown option '--mcp-config'

$ claude agents --settings /dev/null
error: unknown option '--settings'

$ claude agents --plugin-dir /tmp
error: unknown option '--plugin-dir'

$ claude agents --add-dir /tmp
error: unknown option '--add-dir'

The flags that do work (--model, --permission-mode, --effort, --dangerously-skip-permissions) are accepted normally.

Expected behavior

All eight flags listed in the changelog should be accepted by claude agents and forwarded to sessions dispatched from the agent view.

Actual behavior

The four flags above exit immediately with error: unknown option <flag>.

Platform

  • macOS (Darwin 25.5.0)
  • Claude Code 2.1.142

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗