Skip to content
← Back to release · 2.1.305
New features / v2.1.305

[VSCode] Add start-up hooks spinner

CHANGELOG · original

[VSCode] Added a "Running start-up hooks" spinner status, with a screen reader announcement, while SessionStart or Setup hooks run
Open official changelog ↗

Documentation

Documentation excerpt

Use a screen reader

The extension's chat panel works with screen readers. You don't need to turn anything on: the extension announces conversation activity for every user, with no visual change. This is separate from the CLI's opt-in screen reader mode, which adapts the terminal interface.

Screen reader support in the chat panel requires Claude Code v2.1.236 or later.

During a conversation, the extension announces:

  • Claude's replies: the extension announces each reply once, when it's complete, and stays silent while text streams in. Your screen reader reads code blocks as a line-count summary, reads links by their label, and reads tables cell by cell; the full reply stays readable in the transcript.
  • Permission requests and questions: the extension announces a request when its permission prompt appears, naming the tool Claude wants to use. It announces in the same way when Claude asks you a question and when Claude finishes a plan and waits for your review.
  • Status changes: the extension announces when Claude starts working, when Claude is ready for your input, and when Claude Code starts compacting the conversation. If you send a prompt while the session's SessionStart hooks are still running, your screen reader also says "Running start-up hooks."
  • Queued messages: when you send a message while Claude is working, the extension announces "Message queued." for that message.
  • Errors and model prompts: the extension announces errors in the conversation, and announces when the usage-credits consent prompt or the flagged-request prompt appears.

While Claude works, your screen reader reads a text label in place of the progress spinner's animation.

When you reopen a session or switch to another one, the extension announces nothing: restored history, pending permission prompts, and in-progress status stay silent until something new happens.

Use the chat panel from the keyboard

Each turn in the transcript starts with a visually hidden heading labeled with the prompt that started the turn. Use your screen reader's heading navigation to jump between turns.

Within a turn, your screen reader announces whose message you're on as you move through it:

  • Your messages: "You"
  • Claude's messages: "Claude"
  • Tool steps: "Claude" plus the tool name, such as "Claude, Bash"
  • Thinking blocks: "Claude, thinking"

Because the extension exposes the transcript as a labeled region, you can also move focus to the transcript itself with Tab and read it at your own pace. To move focus to the newest message or a waiting permission prompt instead, run Claude Code: Focus last message from the Command Palette.

When a permission prompt option saves a permission rule or directory access, its label ends by naming where the approval is saved, such as "all projects" or "this session". To change the destination:

  • With that option focused, press the Left or Right arrow key. The extension announces each destination as you move to it. The arrow keys require Claude Code v2.1.268 or later.
  • Click the destination in the label.

Documentation snapshot · 2026-11-20

Change details