---
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"}
---

# Claude Code mods gain deeper behavior hooks and transcript-selection access

## Retrieval answer

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.

## Current state (as of 2026-11-17)

**Status: strengthening.** 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.

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.

Claude 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.

### What changed since the original 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. [1][2][3]

### 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

1. [code.claude.com/docs/en/plugins/mods/interface](https://code.claude.com/docs/en/plugins/mods/interface)
2. [Mods overview - Claude Code Docs](https://code.claude.com/docs/en/plugins/mods/overview)
3. [Customize Claude Code with mods in TypeScript](https://claude.com/blog/claude-code-mods)

Rewritten automatically by the New Runtime knowledge desk from the record's weekly updates, releases and archive. The original text is kept as written (2026-10-02); where the two disagree, this section is newer.

## Capability change

- Before: 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: 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.

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.

Buildability: B4. Verification: source-inspected. Related shift: [coding-agent-general-workbench](https://newruntime.com/shifts/coding-agent-general-workbench/).

The mod release opens deeper behavior to plugins, and the following release supplies a concrete UI-context interface. Together they make extensibility more than a general announcement: mods can read what the user selects.

Build selection-aware transcript helpers or review extensions. Watch the fullscreen and single-row boundaries; the built-in “You should know” side agent also has explicit first-party-session and telemetry requirements.

Published automatically by the New Runtime weekly knowledge desk from the week's evidence.

## Supporting evidence

- [claude-code 2.1.287 Claude Code 2.1.287](https://github.com/anthropics/claude-code/releases/tag/v2.1.287) (external, 2026-10-01)
- [claude-code 2.1.288 Claude Code 2.1.288](https://github.com/anthropics/claude-code/releases/tag/v2.1.288) (external, 2026-10-02)

## Provenance

Auto-created by the New Runtime weekly knowledge desk on 2026-11-17 from evidence reviewed in the week of 2026-09-28. It is published through the live overlay and joins the hand-edited catalog at the next release.
