{"name":"agent","slug":"agent","family":"setting","title":"Settings keys","noun":"settings key","description":"Start every session as a named [subagent](\/docs\/en\/sub-agents) with its prompt, tools, and model","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":126,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.305","anchor":"workflow-agent-journal-replaced-key-handling-result-serial","heading":"Resumed workflows handle replaced and unsaved agent results more carefully","line":"Workflow runs now track replaced journal entries, normalize saved results, and warn when an agent() result cannot be saved for resuming","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.305","anchor":"subagent-metadata-sidecar-mirrored-to-the-event-stream-stor","heading":"Subagent details can also be sent to a session's event stream","line":"Saved details about a subagent can now also be sent as an event on the session's event stream, not only written to a file","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.292","anchor":"sendmessage-observable-input-adds-recipient-kind-and-sanitiz","heading":"Messages sent with SendMessage now record what kind of recipient they go to","line":"SendMessage calls shown to hooks and transcripts now include `recipient_kind`, and messages to cloud and Remote Control sessions use new routing","released_at":"2026-10-06 17:10:31","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"workflow-swallows-unhandled-promise-rejections","heading":"Workflow scripts no longer crash on an unhandled failed agent call","line":"When a workflow script leaves a failed agent(), parallel(), pipeline() or workflow() call unhandled, Claude Code logs it and keeps running","released_at":"2026-09-29 17:32:09","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"},{"version":"2.1.281","anchor":"no-session-persistence-check-moved-earlier-and-now-applied","heading":"--no-session-persistence check moved earlier and now applied immediately","line":"`--no-session-persistence` is checked earlier and takes effect at once, and `--managed-settings` and setting sources are passed to child processes","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.274","anchor":"new-mcp-tool-metadata-field-describing-the-serving-mcp-serve","heading":"New MCP tool metadata field describing the serving MCP server","line":"MCP tools now carry structured metadata identifying which server and source they came from, for security purposes","released_at":"2026-09-16 22:36:09","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"title-bar-agenttmux-hint-rendering-split-into-two-independe","heading":"Title-bar agent\/tmux hint rendering split into two independent slots","line":"The title bar's agent name and tmux hint are now computed as two separate, independent pieces","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.269","anchor":"plugin-runtime-api-gains-a-config-surface-alongside-agent","heading":"Plugin runtime API gains a 'config' surface alongside agent\/fs\/store\/etc.","line":"Plugin runtime API gains a new 'config' capability alongside turn, tool, agent, fs and others","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"hooks-engine-gains-sessioncompact-sessionreceive-uireso","heading":"Hooks engine gains session.compact, session.receive, ui.resolve event contracts","line":"The plugin hooks system adds validated event types for session compaction, session receive, and UI resolution","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"}],"entries_total":39,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"api","path":"about-claude\/api-credits-for-subscribers","title":"api-credits-for-subscribers","documented":false},{"source":"api","path":"about-claude\/glossary","title":"glossary","documented":false},{"source":"api","path":"about-claude\/models\/choosing-a-model","title":"choosing-a-model","documented":false},{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false},{"source":"api","path":"about-claude\/pricing","title":"pricing","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/commerce-agents","title":"commerce-agents","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/customer-support-chat","title":"customer-support-chat","documented":false}],"docs_total":14,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/agent","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}