Skip to main content

Docs Settings Reference

VS Code Fixes Settings

Configure 🎯 VS Code Fixes from VS Code Preferences → Settings → Extensions → Power Claude, or edit your settings.json directly.

Auto-generated from the extension's package.json. 7 settings in this category.

SettingDescription
powerClaude.chipDefaultOff.enabled
boolean · default: true
Default the Claude Code "include current file selection in context" chip to OFF on each new chat, and stamp it with the Power Claude attribution badge. Without this, the chip silently defaults ON and feeds your active editor file into every prompt. Patches the installed extension's webview/index.js with a sentinel-bracketed append (MutationObserver-driven, idempotent, anchor-based so it survives extension version drift). Reversible via the .orig backup; re-applied automatically on Claude Code auto-update via the extension self-heal. Reload the VS Code window after toggling for the change to take effect.
powerClaude.messageTimestamps.enabled
boolean · default: true
Stamp each chat message in the Claude Code panel with your local wall-clock time (HH:MM). Pure client-side: the value is rendered by the webview after the message lands, never enters the JSONL transcript, and is invisible to the LLM context (so it costs zero tokens). Patches the installed extension's webview/index.js with a sentinel-bracketed append that uses a MutationObserver to stamp new bubbles as they render. Patch is idempotent and reversible; re-applied automatically on Claude Code auto-update via the extension self-heal.
powerClaude.preserveFocusFix.autoRunOnUpgrade
boolean · default: true
When ON (and preserveFocusFix.enabled is also ON), Power Claude detects Claude Code extension upgrades (via extension.js mtime change) and re-applies the preserve-focus patch automatically. When OFF, you must manually re-run via the command "Power Claude: Re-apply preserve-focus patch" after each Claude Code auto-update.
powerClaude.preserveFocusFix.enabled
boolean · default: false
Stop the Claude Code VS Code extension from yanking your cursor when its panel reveals, output arrives, a session reopens, or a file gets shown. Patches the installed extension to pass preserveFocus:true on every autonomous reveal/show/showTextDocument call. Fixes the upstream focus-steal tracked in anthropics/claude-code#32726 — open with no shipping fix as of 2026-05-20. Patch is idempotent, anchor-based (survives extension version drift), and reversible via the .preserve-focus.orig backup. Re-run after each extension upgrade is automatic when preserveFocusFix.autoRunOnUpgrade is ON. Reload the VS Code window after the first apply for the change to take effect.
powerClaude.sessionAwareness.doubleLaunchGuard.enabled
boolean · default: true
Prevent two VS Code windows from driving the same Claude Code session at once. When you click Resume on a session that is currently active in another window (fresh heartbeat sidecar in ~/.power-claude/state/session-live/), Power Claude shows a modal with Take-over / Open read-only options instead of silently racing the JSONL writer. Two writers on the same session file corrupt history; this gate makes the choice explicit.
powerClaude.sessionAwareness.heartbeatIntervalMs
number · default: 3000
How often (in milliseconds) Power Claude writes a liveness heartbeat sidecar for the session this window owns. Drives the live-running dot in Session Explorer and the freshness check behind the double-launch guard. Clamped to [1000, 30000]. Default 3000 means a session is considered live when its sidecar's last heartbeat is < 10s old (3 ticks).
powerClaude.sessionAwareness.statusBadge.enabled
boolean · default: true
Show a lifecycle status badge at the START of each row in the Session Explorer: 🟢 active, ✅ completed, 🟡 stale, ⚠️ abandoned, 📦 archived. When a session is currently live (fresh heartbeat sidecar < 10s old) and its taxonomy status isn't already 'active', a leading 🟢 overlay is prepended. Driven by the same CoreSessionStatusEnricher that powers the live-running indicator; cached per session ID for O(1) re-render.