Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.269 ·

New list_permission_rules API exposes a session's live permission rules

A new list_permission_rules control request and SDK method expose the same permission-rule list the /permissions command shows

TierUse it nowhow much it should matter to you
Useful4my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaSDKwhat it touches
KindNew Featuresin v2.1.269,
Group of 4 Use it now Notable No documentation found

A new list_permission_rules control request and SDK method expose the same permission-rule list the /permissions command shows

What

  • A new unified function assembles a de-duplicated list of every allow/deny/ask permission rule in effect, drawn from context config plus, for managed installs, every settings-source layer — including rules that aren't currently in effect (marked notInEffect) — each annotated with an editability tier (persistent/session/readonly).
  • A new control request subtype, list_permission_rules, exposes this same data over the control channel/SDK: the session's live permission rules plus workspaceDirectories and originalCwd. This is the same information the /permissions command lists in the terminal, including rules from settings files, session-only approvals, slash-command grants, and --allowedTools flag rules, each tagged with its source.
  • The SDK client class gained matching getHooksListing() and listPermissionRules() methods that issue the get_hooks_listing and list_permission_rules control requests, with matching handlers in the control-request dispatcher.

Why This lets SDK integrations and other tooling inspect a session's effective permission rules programmatically, the same way a person can with /permissions in the terminal.

Read from
Names in the bundlelist_permission_rules

See this entry in the whole of v2.1.269 →