Claude Todos para VSCode e JetBrains
Português · English · Español · 简体中文 · 繁體中文
Observability para seus agentes Claude Code — tasks, árvore de agentes, tempos, tokens e cache ao vivo, restrito ao workspace aberto na janela atual do VSCode. Tudo 100% local: duas janelas em projetos diferentes nunca veem os dados uma da outra.
O que você vê
- Árvore de agentes ao vivo ("mission control") — main → sub-agents → agentes aninhados, com badge de tipo (Explore, Plan, general-purpose…), status e tokens por agente.
- Tasks em tempo real — cada item transiciona
pending → in_progress → completed conforme o agente trabalha; clicar numa task abre o transcript na linha da última mudança de status. Se o orquestrador para de atualizar a lista enquanto sub-agents seguem rodando, o painel sinaliza a defasagem.
- Tempos por task — duração de cada task concluída, tempo ao vivo da task em andamento e estimativa (rotulada como estimativa) do restante.
- Tokens, contexto e cache — tabela por modelo ou por agente, indicador da janela de contexto com semáforo e eficiência de cache (reaproveitado × criado × novo).
- Dashboard "Últimos 7 dias" — uso agregado do projeto, por modelo e por tipo de agente.
- Notificações — toast quando a sessão fica ociosa aguardando você, ou quando todas as tasks completam (só com a janela sem foco).
- UI em 5 idiomas — en, pt-br, es, zh-cn e zh-tw; segue o idioma do VS Code, com override via setting.
Como funciona
O painel Claude Todos (na Barra de Atividades, à esquerda) lê os transcripts que o próprio Claude Code já grava em disco — nenhum proxy, nenhuma API — e reflete tudo em tempo real conforme o agente trabalha.
Não importa onde o claude esteja rodando: pode ser o terminal integrado do VSCode, qualquer terminal externo (Windows Terminal, iTerm, gnome-terminal) ou até a CLI do Claude Code em outra janela. Desde que o diretório de trabalho da sessão bata com o workspace aberto no VSCode, o painel reflete.
Instalação
Plugin JetBrains: o mesmo painel roda nos IDEs da JetBrains — mesma árvore de
agentes, tempos, tokens e dashboard, com toasts nativos, clique na task abrindo o
transcript e picker de sessão. Requer Node.js no PATH (quem roda Claude Code já tem).
O hook é o mesmo dos dois lados: instalar por um IDE já vale para o outro.
- Instale a extensão (tabela acima). O guia "Comece com o Claude Todos" aparece na página Welcome/Get Started do editor e acompanha os passos abaixo.
- No primeiro uso, aceite o aviso para instalar os hooks em
~/.claude/settings.json — a extensão adiciona dois: SessionStart e UserPromptSubmit. Hooks existentes são preservados.
- Abra uma pasta e execute
claude em qualquer terminal. A visão Claude Todos (Barra de Atividades) é populada assim que a sessão tem atividade.
Sessões que já estavam em execução quando você instalou os hooks são detectadas na próxima mensagem que você enviar a elas (é para isso que serve o UserPromptSubmit). Sessões novas são rastreadas imediatamente.
Comandos
| Comando |
Atalho padrão |
| Claude Todos: Open in Editor |
Ctrl+Alt+T / Cmd+Alt+T |
| Claude Todos: Choose Session |
Ctrl+Alt+S / Cmd+Alt+S |
| Claude Todos: Refresh |
— |
| Claude Todos: Install Session Hook |
— |
Configurações
| Configuração |
Padrão |
Efeito |
claudeTodos.claudeDir |
"" (detecção automática via os.homedir()) |
Sobrescreve a localização de ~/.claude. |
claudeTodos.autoInstallHook |
true |
Mostra o aviso de primeira execução pedindo para instalar os hooks. |
claudeTodos.language |
auto |
Idioma da UI do painel (auto | en | pt-br | es | zh-cn | zh-tw). |
claudeTodos.notifications |
true |
Toast quando a sessão fica ociosa ou completa todas as tasks (janela sem foco). |
claudeTodos.activeFolder |
"" |
Multi-root: pasta do workspace a acompanhar; vazio = seguir a sessão mais ativa. |
Privacidade e fluxo de dados
Esta extensão é totalmente local. Nada é enviado para nenhum servidor.
| Arquivo |
Como é acessado |
Por quê |
~/.claude/settings.json |
Lido + escrito (uma vez, com permissão) |
Adiciona dois comandos de hook em hooks.SessionStart e hooks.UserPromptSubmit. Outros hooks e configurações são preservados. |
~/.claude/.vscode-todos-bridge/sessions.json |
Escrito pelo script de hook embarcado |
Registra {cwd, sessionId, terminalPid, startedAt} para a extensão saber qual sessão do Claude pertence a qual janela do VSCode. Limitado a 200 entradas. |
~/.claude/projects/{cwd-encoded}/… |
Apenas leitura |
Transcripts da sessão e dos sub-agents (.jsonl + .meta.json), gravados pelo próprio Claude Code — fonte das tasks, árvore, tempos e tokens. |
~/.claude/todos/ |
Não é tocado |
Localização legada do Claude Code 1.x. Ignorada. |
A extensão nunca modifica seus transcripts e nunca apaga nada.
Requisitos
- VSCode 1.85 ou mais recente
- Claude Code 2.x (qualquer versão que escreva transcripts em
~/.claude/projects/)
- Node.js 20+ no
PATH (o script de hook é um pequeno programa Node)
Compilando a partir do código-fonte
git clone <repo-url>
cd claude-todos-vscode
npm install
npm test # vitest
npm run build # esbuild para a extensão + hook, vite para o webview Svelte
npx vsce package # gera claude-todos-<versão>.vsix
Para rodar a extensão em um host de desenvolvimento: abra a pasta no VSCode e pressione F5 (usa .vscode/launch.json).
Limitações conhecidas
- O script de hook precisa estar acessível pelo caminho armazenado em
~/.claude/settings.json. Se você apagar a extensão manualmente sem desinstalá-la, esses comandos de hook permanecem como no-ops — remova-os à mão ou reinstale e use Claude Todos: Install Session Hook novamente.
Contribuindo
Veja CONTRIBUTING.md para o checklist de smoke-test e o plano de testes manuais.
Licença
MIT
