{"schema_version":"newruntime-agent-readable-v0.2","type":"capability_delta","stable_id":"capability_delta:claude-code-mods-gain-deeper-behavior-hooks-and-transcript-selection","slug":"claude-code-mods-gain-deeper-behavior-hooks-and-transcript-selection","title":"Claude Code mods gain deeper behavior hooks and transcript-selection access","description":"Claude Code introduces mods that let plugins modify deeper behavior, then adds access to selected transcript text. Builders can create extensions that respond to what a user highlights.","retrieval_nugget":"As of 2026-11-17: Claude Code mods have documented, concrete interface hooks: they can add panes or prompt-area bands and redraw parts of Claude Code’s own interface. The available evidence adds implementation detail to the previously described mod and selection capabilities, but does not establish a newer release or a change to selection access.","status":"published","observed_at":"2026-10-02","record_date":"2026-10-02","date_kind":"observed_at","before_capability":"Plugins did not have the newly introduced mod capabilities or the $.ui.selection() interface for reading fullscreen selections.","enabling_change":"Version 2.1.287 introduces Claude Mods; 2.1.288 adds $.ui.selection(), returning selected text and its transcript row when the selection stays within one row.","after_capability":"Plugin builders can modify deeper Claude Code behavior and give mods access to user-selected transcript context.","human_consequence":"Users can highlight transcript material for selection-aware extensions rather than manually copying that context.","verification_level":"source-inspected","buildability_class":"B4","bottleneck":"Selection access is specific to fullscreen mode, and transcript-row context is returned only for selections within one row. The built-in side-agent mod requires first-party sessions with telemetry enabled.","related_shift":"coding-agent-general-workbench","related_posts":[],"topics":[],"source_urls":["https://github.com/anthropics/claude-code/releases/tag/v2.1.287","https://github.com/anthropics/claude-code/releases/tag/v2.1.288"],"featured":false,"supporting_evidence":[{"title":"claude-code 2.1.287 Claude Code 2.1.287","url":"https://github.com/anthropics/claude-code/releases/tag/v2.1.287","kind":"external","observed_at":"2026-10-01"},{"title":"claude-code 2.1.288 Claude Code 2.1.288","url":"https://github.com/anthropics/claude-code/releases/tag/v2.1.288","kind":"external","observed_at":"2026-10-02"}],"routes":{"html":"https://newruntime.com/deltas/claude-code-mods-gain-deeper-behavior-hooks-and-transcript-selection/","markdown":"https://newruntime.com/deltas/claude-code-mods-gain-deeper-behavior-hooks-and-transcript-selection.md","json":"https://newruntime.com/deltas/claude-code-mods-gain-deeper-behavior-hooks-and-transcript-selection.json"},"source_format":"knowledge-ledger","published_at":"2026-11-17T05:08:11.198Z","auto_created":true,"editorial_provenance":{"desk":"knowledge-revision","provider":"codex","model":"gpt-6.1-sol","created_at":"2026-11-17T05:08:11.198Z","week_start":"2026-09-28","review":"auto-created from reviewed evidence; the owner may revise or retire it"},"current_state":{"as_of":"2026-11-17","status":"strengthening","summary":"Claude Code mods have documented, concrete interface hooks: they can add panes or prompt-area bands and redraw parts of Claude Code’s own interface. The available evidence adds implementation detail to the previously described mod and selection capabilities, but does not establish a newer release or a change to selection access.","text":"Mods hook into events such as tool calls, permission requests, and interface drawing. A mod can run before or after an event, replace it, or wrap it. Documentation describes drawing panes and bands with controls, and replacing or restyling elements such as tool-call rows, spinners, and question dialogs.\n\nClaude Code 2.1.287 introduced mods, and 2.1.288 added `$.ui.selection()` for selected text and transcript-row context when a fullscreen selection stays within one row. The newer documentation adds practical interface-development guidance; it does not show that these boundaries or the built-in side-agent requirements have changed. Builders can use mods for interface extensions and selection-aware tools, while accounting for the documented selection limits.","changed_since":[{"text":"Claude Code documentation gives builders concrete ways to draw interface areas and replace or restyle parts of the interface, extending the practical implementation detail beyond the earlier general description of deeper behavior hooks.","sources":["https://code.claude.com/docs/en/plugins/mods/interface","https://code.claude.com/docs/en/plugins/mods/overview","https://claude.com/blog/claude-code-mods"]}],"outdated_in_original":[],"open_questions":["Does a newer Claude Code release change the fullscreen or single-row limits of `$.ui.selection()`?","Have the requirements for the built-in “You should know” side agent changed?","Which documented mod interfaces are available in the newest Claude Code release?"],"watch_next":"Check the next Claude Code release or updated mods documentation for changes to the selection API, mod hooks, or side-agent requirements.","sources":[{"title":"code.claude.com/docs/en/plugins/mods/interface","url":"https://code.claude.com/docs/en/plugins/mods/interface","kind":"archive","observed_at":null},{"title":"Mods overview - Claude Code Docs","url":"https://code.claude.com/docs/en/plugins/mods/overview","kind":"archive","observed_at":null},{"title":"Customize Claude Code with mods in TypeScript","url":"https://claude.com/blog/claude-code-mods","kind":"archive","observed_at":null}],"provenance":{"desk":"living-knowledge","provider":"codex","model":"gpt-6-luna","note":"Rewritten automatically; newer than the original text where they disagree."}}}
