Claude chat for VS Code that shows what Claude Code keeps out of sight: context in tokens, cost per turn, cache,
subscription limits, which subagents are running and what they edited. It runs on the Claude Agent SDK, the same
engine as Claude Code, through your installed claude and its login.
Personal project, not on the Marketplace. Install it from a .vsix (see Install).
Features
Chat in editor tabs. One session per tab. Cmd/Ctrl+Alt+A opens a chat, Cmd/Ctrl+Shift+N starts a new
session.
Gauges by the input box. Context with yellow and orange thresholds, cost and tokens per turn, cache TTL and hit
rate, 5-hour and 7-day limits.
Permissions. Tool approval, agent questions and plan review (ExitPlanMode) are cards in the feed. Edits open
in the native diff.
Sidebar. The project's sessions: search, resume, rename. Account and limits are shown above the list.
Right panel.
changes lists files the session touched.
git is a working tree view where you stage, commit and push. Files the agent edited are marked.
agents shows the turn's subagents.
Agents graph. Opens in its own editor tab: who started whom, the prompt each agent got and the summary it
returned, plus its live calls.
Attachments. Paste screenshots with ⌘V. Attach files with "+" or by dragging them in with ⇧ held. Text and PDF are sent as documents.
Look. Four feed styles, five agent views, three git layouts, three session list densities, your own fonts
(bundled, installed or Google Fonts), separate text sizes for the feed and the rest of the interface.
agentura.agents.view: list, tree, lanes, cards. With graph the agent map opens in an editor tab.
Git tab
agentura.git.layout controls the layout when the workspace has several repositories:
stack gives each repository its own section.
picker puts the repository list on top.
unified shows one list and makes one commit across the repositories you tick.
The ✦ button asks Sonnet to write the commit message from the staged diff.
Sidebar and settings
agentura.sessionList.view: detailed, compact, dense. All settings are also on a settings tab (⚙ in the sidebar),
with live previews.
Install
You need:
VS Code 1.100 or newer.
Claude Code 2.1.285 or newer, installed and logged in (claude, then /login).
The extension does not ship the engine binary (200+ MB). It finds the system claude in PATH, ~/.local/bin,
~/.claude/local or Homebrew (on Windows it looks for claude.exe). To point it somewhere else, set agentura.claudeExecutable.
code --install-extension agentura-0.3.0.vsix
To build from source:
npm ci
npm run check # types, lint, unit tests, build
npm run package # agentura-0.3.0.vsix
Settings
Everything is under agentura.*. You can change it in the Settings UI or on the settings tab. These two settings are read from
user settings only, so a cloned repository can't change them through its .vscode/settings.json:
Setting
Default
Meaning
agentura.claudeExecutable
empty
Path to claude; empty means auto-detect
agentura.allowBypassPermissions
false
Allow the bypassPermissions mode
If agentura.defaultPermissionMode is set to bypassPermissions while bypass is not allowed, new sessions start in
manual mode.
Known limitations
Login and ToS. Anthropic does not allow third-party products to offer claude.ai login without approval.
Agentura has no login of its own and uses the CLI's login. That is fine for personal use, but publishing it would need either approval or API keys.
Limits come from an undocumented endpoint (/api/oauth/usage) and may break. If they do, the extension falls
back to the engine's rate_limit_event, which doesn't say which window the limit belongs to.
Transcripts (~/.claude/projects/*.jsonl) use an internal format. Session totals are parsed from them and can
drift after a CLI update.
Cost is an estimate. Your subscription bill is the source of truth.
Each chat tab runs its own claude process.
Subagents have no separate cost or token counts because the engine does not report them. Prompt and summary sizes are
estimated from text length.
Tested only on macOS arm64. CI runs on macOS and Ubuntu, but nobody has used it by hand on Windows or Linux.
Development
npm run watch # rebuild extension and webviews
npm test # unit tests (vitest)
npm run test:integration # integration test in a downloaded VS Code
node scripts/vsix-verify.mjs [--live] # check the built .vsix; --live runs one Haiku turn
node scripts/readme-shots/run.mjs # re-render the screenshots above (needs npm run build)
Where things are:
src/agent is the SDK adapter.
src/data covers sessions, limits and prices.
src/extension is the extension host.
src/webview is the Preact UI.
prototype/ is the reference markup.
Agentura: Show State (debug) opens state fixtures without the engine. The scripts/*-smoke.mjs scripts run the live engine
and spend tokens. The plan and decision log are in docs/roadmap/ (in Russian).
