{"name":"--agent","slug":"agent","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Specify an agent for the current session (overrides the `agent` setting)","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.290","anchor":"spawned-teammates-now-get-proactivity-passed-through","heading":"Teammates now inherit the lead session's proactivity level","line":"Teammates started by a lead session now receive `--proactivity` with the lead's level when one is set","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"agent-seating-can-re-apply-the-agent-system-prompt","heading":"Agent seating can re-apply the agent system prompt","line":"Starting a session with --agent now goes through one helper, which can also re-apply the agent's system prompt when that agent is already active","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text, named in this entry"},{"version":"2.1.274","anchor":"fleet-view-background-agent-relaunch-can-now-target-a-specif","heading":"Fleet view background-agent relaunch can now target a specific agent type","line":"Fleet view can now relaunch a background agent as a specific agent type after an update","released_at":"2026-09-16 22:36:09","reason":"named in this entry, found in this entry's text"},{"version":"2.1.234","anchor":"spawned-processes-get-flag-value-when-the-value-looks-like-a","heading":"Spawned processes get --flag=value when the value looks like a flag","line":"Prompts and model names starting with a dash are no longer swallowed as options by subagents and background tasks.","released_at":"2026-08-17 18:19:13","reason":"found in this entry's text"},{"version":"2.1.232","anchor":"cloud-gateway-sign-in-explains-its-restart-and-refuses-when-","heading":"Cloud gateway sign-in explains its restart, and refuses when it cannot","line":"Cloud gateway sign-in explains its restart, and ends the session when a restart can't carry state.","released_at":"2026-08-13 21:30:53","reason":"found in this entry's text"}],"entries_total":5,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"api","path":"cli-sdks-libraries\/cli\/scripting","title":"scripting","documented":false},{"source":"api","path":"cli-sdks-libraries\/cli\/using","title":"using","documented":false},{"source":"api","path":"managed-agents\/agent-setup","title":"agent-setup","documented":false},{"source":"api","path":"managed-agents\/budgets","title":"budgets","documented":false},{"source":"api","path":"managed-agents\/define-outcomes","title":"DCF Model Rubric","documented":false},{"source":"api","path":"managed-agents\/environments","title":"environments","documented":false},{"source":"api","path":"managed-agents\/files","title":"files","documented":false},{"source":"api","path":"managed-agents\/github","title":"github","documented":false},{"source":"api","path":"managed-agents\/mcp-connector","title":"mcp-connector","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/agent","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}