Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.268 ·

Tool permission prompts can show a structured explanation card

Permission-ask dialogs can now show a structured 'card' explaining the decision, and addon tools can supply one.

TierYou'll noticehow much it should matter to you
Useful3my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaPermissionswhat it touches
KindImprovementsin v2.1.268,
Group of 2 You'll notice No documentation found

Permission-ask dialogs can now show a structured 'card' explaining the decision, and addon tools can supply one.

What

  • Tool-permission prompt info can now include an optional structured card (with a question, lines, and values) shown when the permission decision reason is a safety check or similar, there's no matched ask-rule, and no denial-limit fallback applies. The card content comes from the tool's own permissionCard callback.
  • The generic addon-tool factory now includes a permissionCard property in the tool definition it builds, and wraps the finished tool object with a helper before returning it, so addon tools can supply this card.

Why This gives you a clearer, structured explanation (instead of plain text) when Claude Code asks permission to run a tool for safety reasons, and extends that capability to addon tools.

Read from
Names in the bundlepermissionCard

See this entry in the whole of v2.1.268 →

Feedback