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 newclaude agentsflags:--add-dir,--settings,--mcp-config,--plugin-dir,--permission-mode,--model,--effort, and--dangerously-skip-permissionsto 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
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗