session
A Claude Code settings key, read out of the shipped bundle. It was in the build from v2.1.315 and was gone by v2.1.317.
A per-session workshop document gets snapshotted with your session files and is only writable in plan mode.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.219.
In the changelogs
31Releases whose published page names session.
-
v2.1.312
Remote Control shows helper status and lets you disconnect with x
Remote Control now shows a status line per helper and a long-running row, and pressing x twice disconnects cloud sessions from your folder
found in this entry's text
-
v2.1.299
Plugin hooks gain session identity and prompt media methods
Plugin hook modules can now call session.identity and prompt.media, mark registrations as withheld, and get fuller error details
found in this entry's text
-
v2.1.292
Messages sent with SendMessage now record what kind of recipient they go to
SendMessage calls shown to hooks and transcripts now include
recipient_kind, and messages to cloud and Remote Control sessions use new routingfound in this entry's text
-
v2.1.290
claude remote-controlcan let cloud sessions run commands in a folder unattendedA new
--allow-unattended-tool-callsoption lets cloud sessions use the current folder for one run, with auto-mode commands running without askingfound in this entry's text
-
v2.1.290
Hooks modules treat AGENTS.md specially, and plugin refusals say more
In hooks modules,
$.fs.ancestorstakes new options and handles AGENTS.md specially; plugin refusals say when they happenedfound in this entry's text
-
v2.1.275
Policy manifest gains session.root, prompt.read, ui.panes surface entries
Plugin API policy list adds session.root, prompt.read, and ui.panes as permitted actions
found in this entry's text
-
v2.1.274
Bridge inbox message fetch now logs fetch attempts against the message queue
Bridge inbox message fetch now logs each fetch attempt against the message queue
found in this entry's text
-
v2.1.272
New background-runner epoch/retry constants for session failure handling
New retry timing and stale-session detection added to background session failure reporting
found in this entry's text
-
v2.1.271
Fleet/job re-attach login screen no longer passed a
sessionpropFleet job re-attach login screen no longer receives a session prop
found in this entry's text
-
v2.1.268
Bridge session fetch now blocked for third-party providers
Bridge session fetches are now blocked outright for non-Anthropic providers
found in this entry's text
-
v2.1.267
Plugin/hook capability namespace gains session and env access
Hooks and plugins can now access session usage stats and read/write environment variables
named in this entry
-
v2.1.260
Permission-denied MCP tool errors now mark the MCP client as needing auth via session wiring
MCP auth-needed marking on permission errors was refactored, no behavior change expected.
found in this entry's text
-
v2.1.257
New
$.session.authorizeplugin hook API surfacePlugins gain $.session.authorize(), which mints an auth handle for the session.
found in this entry's text
-
v2.1.257
MCP request headers now scanned for leaked credential-like values
Outgoing MCP request headers are scanned for credential-looking names and values, which are recorded.
found in this entry's text
-
v2.1.257
Init frame schema gains 'host' and 'serving' fields for local tool serving to cloud sessions
The init frame can announce the local machine and whether it serves Bash, Read, Write and Edit calls to a cloud session.
found in this entry's text
-
v2.1.257
Cloud-session credential guard added as a permission source
A new permission-rule source called the cloud-session credential guard joins the existing rule sources.
found in this entry's text
-
v2.1.257
New 'hostCredential' permission-decision source and 'consent' tool-envelope key
A hostCredential permission source and a reserved consent envelope key are in place, with nothing yet setting or reading them.
found in this entry's text
-
v2.1.248
Remote machines can send their own auto-mode rules with a tool-call approval request
A remote machine's permission rules can now influence approvals for tool calls it asks about.
found in this entry's text
-
v2.1.248
Redaction patterns for logs and transcripts made concrete
Redaction patterns for credentials, session ids and phone numbers are now concrete constants.
found in this entry's text
-
v2.1.246
A self-contained git implementation for folder sync
Folder sync now carries its own git-style object store and packfiles instead of the old journal.
found in this entry's text
-
v2.1.242
Plugin modules with a
$API that can hook events and redraw the terminal UIPlugins can install code that intercepts tool calls and repaints parts of the terminal interface.
found in this entry's text
-
v2.1.239
Relayed coordinator messages are labelled and escaped
Coordinator messages forwarded to worker agents are labelled and escaped so they can't fake markup.
found in this entry's text
-
v2.1.228
SDK client gains fetch middleware and wider streaming event coverage
The bundled API client can wrap network calls and understands more streaming event types.
found in this entry's text
-
v2.1.228
Self-hosted runner waits for the turn that follows a background task
A session still owing a report after a background task stays alive instead of being treated as idle.
found in this entry's text
-
v2.1.224
Plans and session records read through the keyed store
Plans and session records are now addressable through the keyed storage layer, not just as files.
found in this entry's text
-
v2.1.219
Workshop doc: snapshots, plan-mode writes and verified slugs
A per-session workshop document gets snapshotted with your session files and is only writable in plan mode.
found in this entry's text
- v2.1.196
-
v2.1.124
Scoped history search (Ctrl+S to cycle)
found in this entry's text
-
v2.1.91
Ultraplan Cloud Planning UI [Gradual Rollout]
found in this entry's text
-
v2.1.72
Remote Control Spawn Mode Overhaul
found in this entry's text
-
v2.0.56
Telemetry Reliability Overhaul
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
2Build by build
5One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.