New SDK/CLI option inheritPermissionMode

A new inheritPermissionMode option in the headless entrypoint lets a session take its parent's permission mode.

Use it now Notable No documentation found New Features

JSON All of v2.1.257

Use it nowTier: how much it should matter to you

5Useful: my rating, 1 to 5

4Signal: worth watching, 1 to 5

PermissionsArea: what it touches

New FeaturesKind: in v2.1.257, 01 Sep 26

What probably matters to youSection of the release

A new inheritPermissionMode option is now available among the headless/print entrypoint options, alongside existing ones like addDir and fallbackModel. It appears intended to let a spawned session inherit its parent's permission mode.

Read from

Names in the bundleinheritPermissionMode

See this entry in the whole of v2.1.257 →

The build it came inv2.1.257

1 Sep 2026 · 505 entries, this one is #33.

Use it now45
You'll notice231
Nothing to try yet71
Under the hood158

Either side of it

v2.1.252Older
v2.1.258Newer

Open the release →

Names in this entry

settinginheritPermissionMode
A new inheritPermissionMode option in the headless entrypoint lets a session take its parent's permission mode.
settingfallbackModel
Name backup models for when the primary is overloaded

Is this right?

Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.

v2.1.274 Explore agent no longer inherits model cap on non-first-party providers
Both mention inherit
v2.1.299 Subagents can be given the user's earlier verified messages
Both mention inherit