ClaudeQueue

🌐 English · Português

🇺🇸 English

Queue prompts for Claude Code with parallel sessions and real-time streaming, right in the VSCode side panel.

Keep typing while Claude responds. Run multiple conversations in parallel. Watch responses being written letter-by-letter. All native to VSCode, no extra terminal needed.

⚠️ Important: requires a paid Anthropic plan

This extension is a wrapper around the official Claude Code CLI — it doesn't talk to any API on its own. All conversations go through your local claude CLI, which in turn calls Anthropic's API using your account.

To use it you need one of the options below:

Plan	When it makes sense
Claude Pro	Light usage, short prompts, Sonnet/Haiku models
Claude Max	Heavy usage, Opus, large projects
API Key (pay-as-you-go)	Technical/enterprise usage, no subscription

Official details: https://www.anthropic.com/pricing

💡 This extension tracks tokens and cost per session in the footer so you can monitor consumption in real time (donut indicator + detailed tooltip).

Features

💬 Multiple sessions in parallel — each with its own Claude conversation
📥 Prompt queue — type away, items wait in line, processed serially without losing order
⚡ Real-time streaming — each token appears as it arrives
🧠 Prompt BI — per-session toggles to auto-plan and/or delegate to subagents via /goal and /agents, with check mode (ask for approval first) or force mode (execute directly with a live checklist)
📋 Sticky PlanChecklist — top-of-chat box that lights up step-by-step in real time during a planned execution, with hide button and cancel-remaining
🔁 Auto-review at the end — after running a plan, Claude verifies every step with evidence and offers to re-run anything that was skipped
📥 /import @file.md — turn a Markdown task list into N queue items in one shot (Haiku-powered parser with regex fallback)
🤖 Auto-compact at 95% of context — reduces cost automatically
📎 Attach files with @ (native dialog, multi-select)
🎯 Per-session model selector (Fable 5, Opus 4.8, Sonnet, Haiku, custom IDs)
🔢 Live output-token counter in the status strip ("↓ N tokens") — estimated from streamed content while the turn runs, just like Claude Code's spinner
🖱️ Drag & drop to reorder the queue
📁 Workspace isolation — sessions filtered by current folder
🔍 Search within session messages (Ctrl+F)
🔄 Resume after reload — queued items continue from where they left off
💀 Truly kills the process — taskkill /T on Windows, no orphans
📊 Token and cost tracking per session (donut indicator in the footer)
📤 Export chat to .txt before deleting a session
🔁 Multi-process — enqueue the same prompt N times (1–100)
✏️ Edit and resend user message (replaces in the transcript)
📋 Copy responses with hover over the Claude bubble
🌐 Bilingual UI — every label available in English and Portuguese, toggleable via a flag button (🇺🇸/🇧🇷) in the header

Prerequisites

1. VSCode 1.85 or higher

Check at Help → About.

2. Node.js 18 or higher

Required to install and run the Claude Code CLI.

node --version   # must return v18.x or higher

If you don't have it, download from https://nodejs.org

3. Claude Code CLI installed

Install globally via npm:

npm install -g @anthropic-ai/claude-code

Then confirm it's in PATH:

claude --version
# should show something like: 2.1.142 (Claude Code)

4. Authentication on Claude

Run the CLI once outside VSCode to log in with your paid account:

claude

It opens the browser asking for login on your Anthropic account (Pro, Max, or via API key). After this, the auth token gets saved on your system and the extension uses that authentication automatically.

🔒 The extension does NOT ask for your API key or login. It just runs the claude CLI already authenticated by you.

Getting started

Click the ClaudeQueue icon in the Activity Bar (left side bar)
Click + nova to create your first session
Type a prompt and press Enter
While Claude responds, keep typing — they go into the queue

The first message creates the conversation. The next ones continue the context via --resume. Each session is isolated.

Detailed guide for each feature

🗂️ Sessions

Each session is a separate conversation with Claude. You can have several running in parallel (one per tab in the left sidebar).

Available operations (right-click on the session):

Rename — give it a friendly name ("refactor API", "docs", "exploration")
Duplicate — creates a new session with the same cwd and model (fresh conversation, no history)
Archive — hides from the main list without deleting
Unarchive — click the "archived" section at the bottom of the list
Delete — opens modal with option to export chat to .txt beforehand
Change working folder — click the 📁 icon in the header

The active session is highlighted in orange. Click another in the sidebar to switch.

📥 Prompt queue

The queue appears below the session list. Each item has a colored pill:

🟢 RUNNING (green, pulsing) — in execution
🔵 QUEUED (blue) — waiting its turn
🟡 AWAITING (yellow) — waiting for an answer to Claude's question
🟢 DONE (green) — finished successfully
🔵 STOPPED (blue) — you cancelled/killed it
🔴 ERROR (red) — failed (hover to see the message)

Operations (right-click or ⋮ menu):

Edit prompt (only queued items) — shortcut E
Move up/down — shortcuts Shift+K / Shift+J or drag & drop
Duplicate — adds a copy at the end of the queue
Multi-process... — opens modal to enqueue N copies (1–100)
Cancel — shortcut Del (kills the process if running)
Resend (only finished) — shortcut R
Delete from history (only finished) — removes from queue AND chat

Drag & drop: hover over a queue item, hold the click and drag to reorder. Works only with items in QUEUED status.

🔍 Message search

Ctrl+F or click the 🔍 button in the top-right corner of the chat:

Type the term
Matches get highlighted in orange
Non-matches get dimmed (30% opacity)
↑/↓ arrows or Shift+Enter/Enter navigate between matches
n/total counter at the top
Esc closes

🤖 Model selection

Button model: ▾ in the top-right corner of the header. Opens dropdown with:

Model	Context	Max output	When to use
Default	—	—	Uses the CLI's default
opus (alias)	1M	64k	Always the latest Opus
sonnet (alias)	200k	64k	Always the latest Sonnet
haiku (alias)	200k	32k	Always the latest Haiku
claude-fable-5	1M	128k	Most powerful (tier above Opus)
claude-opus-4-8	1M	128k	Most capable, current
claude-opus-4-7	1M	64k	Previous
claude-opus-4-5	200k	64k	Legacy
claude-sonnet-4-6	200k	64k	Balanced, current
claude-haiku-4-5-20251001	200k	32k	Fast and cheap

There's an option to type a custom ID if you want to pin a specific version.

📌 New session default: claude-opus-4-8 (1M tokens of context, 128k output). Change via the dropdown if you prefer another.

📎 Attach files

@ button next to the prompt box. Opens the native Windows/Mac/Linux file picker with multi-select. Paths are inserted in the prompt as @file.txt @another.md.

Claude Code understands the @path syntax natively — when it sees this in the prompt, it reads the file automatically.

💡 Paths inside the working folder become relative (cleaner). Outside become absolute.

🤖 Auto-compact at 95%

When session context usage reaches 95% of the model's window (190k tokens on 200k models, 950k on 1M models), the extension automatically queues a /compact with priority.

The /compact goes to the front of the queue and runs first
Your next messages wait for it to finish
Then context drops (usually to 30–40%) and processes normally
You save tokens (each turn re-sends the full history via --resume)

There's anti-loop protection: if /compact doesn't lower usage, it doesn't fire again.

🛡️ Bypass permissions

Toggle in the bottom-left corner. When ACTIVE (red):

Claude can use write tools (Edit, Write, Bash) without asking
Faster for long jobs
More dangerous (can write where it shouldn't)

When disabled, permission prompts are blocked (still in development — defaults to acceptEdits).

📊 Token and cost tracking

Donut in the bottom-right shows:

% remaining until auto-compact with color (green/yellow/red)
↑ tokens sent (new input + cache write)
↓ tokens received (output)
✓ cache read (re-used, costs 10% of normal input)
$cost accumulated USD

Hover the donut to see detailed tooltip with:

Claude session ID (UUID)
Model in use
Current turn context X/Y (Z%)
Total sent/received/cache/cost for this session
Explanation of why it looks like a lot (system prompt + history)

Right-click the donut: option to reset counters for this session.

✏️ Edit user message

Hover over a YOU message to show icons:

⧉ copy
✎ edit and resend — opens inline textarea, Ctrl+Enter sends, Esc cancels. The original message is removed from the transcript and the new text goes to the queue with priority.

💡 Claude's context (--resume) still contains the original message — but the chat in the UI shows only the new version.

📋 Copy Claude responses

Hover over a CLAUDE message to show purple border + ⧉ copy icon. Click and the text goes to the clipboard.

🖱️ Customizable layout

Left column (sessions + queue): drag the orange vertical divider to adjust width. Double-click resets.
Prompt box: drag the horizontal divider above it to grow/shrink (useful for multi-line prompts). Double-click resets.
Widths persist in localStorage — survive reload.

📁 Workspace isolation

Sessions are filtered by the folder currently open in VSCode — matched exactly, the same way Claude Code keys projects by directory. Sessions created in other folders (including subfolders of the open one) stay hidden until you open that exact folder. Isolation is always on; to see a session, open the folder it was created in.

🧠 Prompt BI — auto-planning with `/goal` and `/agents`

Open the BI chip in the header (next to model/effort) and you'll see two independent radios — Goal and Agents — each with three states: off, check, force. There's also an Auto-review at the end toggle.

Mode	What it does
off	Prompt goes raw to Claude — same as no BI
check	Before running, Claude generates a plan and a PlanApprovalModal opens with Approve / Reject / Reprocess (with feedback textarea). Only after you approve does the plan execute.
force	Prompt is prefixed automatically (using `/goal` and/or `/agents`) and Claude runs straight away with a live checklist showing each step

When at least one mode is active, every prompt in that session goes through the BI pipeline. The badge BI g:c a:f in the header shows the current state at a glance.

Approval popup (check mode):

Numbered list with title + short subtitle + suggested subagent
Approve → executes with the agreed plan
Reject → cancels the item entirely
Reprocess → textarea where you describe what to change ("split step 3", "drop step 5"), Claude generates a new plan with your notes baked in. While regenerating, the PlanChecklist shows "Regenerating plan with your notes…" with a pulsing badge.

📋 PlanChecklist (sticky on top)

Whenever a plan is attached to a queue item (check approved OR force), a fixed panel renders at the top of the chat with header Plan · X/Y and the enumerated steps.

Live states: ⏳ queued · ▶ running (orange, pulsing) · ✓ done · ✗ failed · ⊘ not executed (filled by auto-review)
▾ collapses only the list (header stays)
✕ hides everything → thin strip "Plan hidden · X/Y · show" with a pulsing dot when work is in progress. Click the strip to bring it back. The hide flag is per-item, so reprocessing reopens fresh.
Cancel remaining (N) button while running — kills the process; pending steps don't execute
Click a ✓ step to jump in the chat to where it ran (matched by queueItemId)
Stays in history after the run ends, so you can revisit later

🔁 Auto-review at the end

When a plan finishes executing and Auto-review at the end is on (default), the extension fires one more --resume turn asking Claude to verify each step with concrete evidence (file, command, snippet).

Steps with evidence → stay ✓
Steps without evidence → ⊘ "not executed" (yellow, tooltip shows the reason)
If any ⊘ exist, a PlanFollowupModal opens with a checklist of the pending steps and asks: "Execute selected (N)" / "No, leave as is"
Picking "yes" enqueues a focused prompt that asks Claude to run exactly the selected steps

While the review turn is in flight, PlanChecklist shows "Reviewing — checking evidence per step…" with a pulsing badge.

📥 `/import @file.md` — bulk-enqueue from Markdown

Type /import @file.md (or /import path/to/file.md) in the prompt input. ClaudeQueue intercepts the command, reads the file, and opens an ImportPreviewModal listing every executable task it detected.

Parser: by default uses Haiku one-shot (claudequeue.importParserModel: "smart") — better for prose-heavy docs. Falls back to a pure-JS heuristic (## headings, - [ ] task list, 1. 2. 3. numbered lists) if Haiku is unavailable. Set the setting to "regex" to force offline mode.
Each detected task shows: id, title (max 6 words), short subtitle, expandable content
Check/uncheck to control what gets enqueued (start with all selected)
Confirm → each item becomes a separate queue entry that runs serially in the same --resume, preserving context across tasks
Combine with the BI modes: importing 15 tasks in a session with Agents: force will delegate each one to subagents automatically

🔄 Recovery after reload

If you reload the VSCode window (or it crashes and you reopen):

QUEUED items remain queued
The item that was RUNNING returns to QUEUED at the start (re-runs from scratch)
Already DONE/STOPPED/ERROR items stay preserved in history

Anything you didn't explicitly cancel continues from where it left off.

Keyboard shortcuts

Key	Action
`Ctrl+Alt+C`	Open ClaudeQueue panel
`Ctrl+Alt+N`	New session
`Ctrl+Alt+Enter`	Send editor selection as prompt
`Enter`	Enqueue prompt
`Ctrl+Enter`	Enqueue with priority (jumps to front)
`Ctrl+Shift+Enter`	Broadcast to all sessions
`Shift+J` / `Shift+K`	Reorder selected queue item ↓/↑
`Del`	Cancel selected item
`E`	Edit prompt (only queued items)
`R`	Re-enqueue finished item
`Ctrl+F`	Search within session messages

Settings

All start with claudequeue.:

Key	Default	Description
`binaryPath`	`""`	Explicit path to `claude` (empty = auto-detect)
`defaultPermissionMode`	`acceptEdits`	`default`, `acceptEdits` or `bypassPermissions`
`allowBypass`	`true`	Shows "Bypass permissions" toggle in the footer
`autoDetectQuestions`	`false`	Highlights answers ending in `?`
`maxParallelWarning`	`5`	Warning when exceeding this number of parallel sessions
`statusIdleThresholdMs`	`800`	Shows "Wandering..." after Xms without a new token
`brokerTimeoutSeconds`	`300`	Permission prompt timeout (auto-deny)
`notifyOnFinish`	`true`	Status bar notifies when item finishes
`workspaceIsolation`	`true`	Sessions are isolated per folder by exact cwd match (subfolders excluded). Isolation is always on.
`importParserModel`	`smart`	`/import @file.md` parser: `smart` (Haiku one-shot) or `regex` (offline only)

Common workflows

"I want to refactor 10 files in a row without having to keep watching"

Create a session, model Opus 4.8
Enable Bypass permissions (footer)
Send 10 prompts in sequence (Enter between each): "refactor @file1.ts ...", "now @file2.ts ...", etc.
Go do something else. Each item processes serially, saving the files.
When you come back, all finished. Check the transcript.

"I want to compare the same question across different models"

Create 3 sessions, each with a different model (Opus 4.8, Sonnet 4.6, Haiku 4.5)
Focus one session, send the prompt
Focus the next, send the same prompt
(or use Ctrl+Shift+Enter to send the same prompt to ALL at once)
Compare the answers

"I want to run the same prompt 50 times to test consistency"

Send the prompt once
When it finishes, right-click → Multi-process... → type 50
The 50 copies enter the queue
Go grab some coffee — takes a few minutes

"Session is heavy (200k tokens, cost climbing)"

Wait for auto-compact to fire at 95%
OR manually send a /compact prompt (it summarizes the conversation and lowers context)
OR create a new session for the next topic (recommended for switching domains)
OR right-click the donut in the footer → Reset counters (cleans the stat but doesn't change Claude's actual context)

Privacy & cost

All conversations go through your local claude CLI to Anthropic's API — exactly the same as using Claude Code directly in the terminal
Costs and tokens are shown per session in the footer
Each turn re-sends the history (normal Claude Code behavior via --resume, not a peculiarity of this extension)
Auto-compact at 95% reduces context to save money
Data stays on your local disk in the extension's globalStorage (SQLite). Nothing is sent to another server beyond what goes to Anthropic via the official CLI.

Where data is saved

Everything goes to the extension's globalStorage in VSCode:

Windows: C:\Users\<you>\AppData\Roaming\Code\User\globalStorage\danielrafaelramos.claudequeue\
macOS: ~/Library/Application Support/Code/User/globalStorage/danielrafaelramos.claudequeue/
Linux: ~/.config/Code/User/globalStorage/danielrafaelramos.claudequeue/

The main file is state.db (SQLite). You can delete it to reset everything (loses sessions and transcript).

License

MIT — see the LICENSE file in the repository.

🇧🇷 Português

Enfileire prompts para o Claude Code com sessões em paralelo e streaming em tempo real, direto no painel lateral do VSCode.

Continue digitando enquanto o Claude responde. Crie várias conversas em paralelo. Veja a resposta sendo escrita letra-a-letra. Tudo nativo no VSCode, sem terminal extra.

⚠️ Importante: precisa de plano pago da Anthropic

Esta extensão é um wrapper do Claude Code CLI oficial — ela não fala com nenhuma API por conta própria. Todas as conversas passam pelo seu claude CLI local, que por sua vez chama a API da Anthropic usando a sua conta.

Para usar você precisa de uma das opções abaixo:

Plano	Quando faz sentido
Claude Pro	Uso leve, prompts curtos, modelos Sonnet/Haiku
Claude Max	Uso pesado, Opus, projetos grandes
API Key (pay-as-you-go)	Uso técnico/empresarial, sem mensalidade

Detalhes oficiais: https://www.anthropic.com/pricing

💡 Esta extensão rastreia tokens e custo por sessão no rodapé pra você acompanhar o consumo em tempo real (donut indicator + tooltip detalhado).

Funcionalidades

💬 Múltiplas sessões em paralelo — cada uma com sua própria conversa Claude
📥 Fila de prompts — você digita, fica na fila, processa serial sem perder ordem
⚡ Streaming em tempo real — cada token aparece conforme chega
🧠 BI de prompts — toggles por sessão para auto-planejar e/ou delegar a subagentes via /goal e /agents, com modo check (pede sua aprovação primeiro) ou modo force (executa direto com checklist ao vivo)
📋 PlanChecklist fixo no topo — caixa que acende passo-a-passo em tempo real durante a execução planejada, com botão de ocultar e cancelar restantes
🔁 Revisão automática no final — após executar um plano, o Claude valida cada etapa com evidência e oferece rodar o que ficou pendente
📥 /import @arquivo.md — transforma uma lista de tarefas em Markdown em N itens da fila (parser via Haiku com fallback regex)
🤖 Auto-compact em 95% do contexto — reduz custo automaticamente
📎 Anexar arquivos com @ (diálogo nativo, multi-seleção)
🎯 Selecionar modelo por sessão (Fable 5, Opus 4.8, Sonnet, Haiku, custom IDs)
🔢 Contador de tokens ao vivo no status strip ("↓ N tokens") — estimado pelo conteúdo transmitido enquanto o turno roda, igual ao spinner do Claude Code
🖱️ Drag & drop pra reordenar a fila
📁 Isolamento por workspace — sessões filtradas pela pasta atual
🔍 Busca dentro das mensagens da sessão (Ctrl+F)
🔄 Resume após reload — itens enfileirados continuam de onde pararam
💀 Mata processo de verdade — taskkill /T no Windows, sem orfãos
📊 Tracking de tokens e custo por sessão (donut indicator no rodapé)
📤 Exportar chat pra .txt antes de deletar uma sessão
🔁 Multi-processar — enfileira o mesmo prompt N vezes (1–100)
✏️ Editar e reenviar mensagem do usuário (substitui no transcript)
📋 Copiar respostas com hover sobre a bolha do Claude
🌐 Painel bilíngue — todos os labels disponíveis em Português e Inglês, alternáveis por um botão de bandeira (🇧🇷/🇺🇸) no header

Pré-requisitos

1. VSCode 1.85 ou superior

Confira em Help → About.

2. Node.js 18 ou superior

Necessário pra instalar e rodar o Claude Code CLI.

node --version   # precisa retornar v18.x ou maior

Se não tiver, baixe em https://nodejs.org

3. Claude Code CLI instalado

Instale globalmente via npm:

npm install -g @anthropic-ai/claude-code

Depois confirme que está no PATH:

claude --version
# deve mostrar algo tipo: 2.1.142 (Claude Code)

4. Autenticação no Claude

Rode o CLI uma vez fora do VSCode pra fazer login com sua conta paga:

claude

Vai abrir o navegador pedindo login na sua conta Anthropic (Pro, Max, ou via API key). Depois disso, o token de auth fica salvo no seu sistema e a extensão usa essa autenticação automaticamente.

🔒 A extensão NÃO pede sua API key nem seu login. Ela só executa o claude CLI já autenticado por você.

Como começar

Clique no ícone ClaudeQueue na Activity Bar (barra lateral esquerda)
Clique em + nova pra criar sua primeira sessão
Digite um prompt e aperte Enter
Enquanto o Claude responde, continue digitando — vão entrando na fila

A primeira mensagem cria a conversa. As próximas continuam o contexto via --resume. Cada sessão é isolada.

Guia detalhado de cada funcionalidade

🗂️ Sessões

Cada sessão é uma conversa separada com o Claude. Você pode ter várias rodando em paralelo (uma por aba na sidebar esquerda).

Operações disponíveis (botão direito na sessão):

Renomear — dá um nome amigável ("refactor API", "docs", "exploração")
Duplicar — cria nova sessão com o mesmo cwd e modelo (conversa nova, sem histórico)
Arquivar — esconde da lista principal sem deletar
Desarquivar — clica na seção "arquivadas" no fim da lista
Deletar — abre modal com opção de exportar chat para .txt antes
Trocar pasta de trabalho — clique no ícone 📁 do cabeçalho

A sessão ativa fica destacada em laranja. Clique em outra na sidebar pra trocar.

📥 Fila de prompts

A fila aparece embaixo da lista de sessões. Cada item tem um pill colorido:

🟢 RODANDO (verde, pulsando) — em execução
🔵 FILA (azul) — aguardando vez
🟡 AGUARDA (amarelo) — esperando resposta de pergunta do Claude
🟢 FEITO (verde) — terminou com sucesso
🔵 PARADO (azul) — você cancelou/matou
🔴 ERRO (vermelho) — falhou (passa o mouse pra ver a mensagem)

Operações (botão direito ou menu ⋮):

Editar prompt (só itens enfileirados) — atalho E
Mover acima/abaixo — atalhos Shift+K / Shift+J ou drag & drop
Duplicar — adiciona cópia ao final da fila
Multi-processar... — abre modal pra enfileirar N cópias (1–100)
Cancelar — atalho Del (mata o processo se estiver rodando)
Reenviar (só finalizados) — atalho R
Excluir do histórico (só finalizados) — apaga DA fila E do chat

Drag & drop: passa o mouse sobre um item da fila, segura o clique e arrasta pra reordenar. Funciona só com itens em status FILA.

🔍 Busca nas mensagens

Ctrl+F ou clique no botão 🔍 no canto superior direito do chat:

Digita o termo
Matches ficam destacados em laranja
Não-matches ficam dimmed (opacidade 30%)
Setas ↑/↓ ou Shift+Enter/Enter navegam entre matches
Contador n/total no topo
Esc fecha

🤖 Seleção de modelo

Botão model: ▾ no canto superior direito do header. Abre dropdown com:

Modelo	Contexto	Output máx	Quando usar
Default	—	—	Usa o default do CLI
opus (alias)	1M	64k	Sempre o Opus mais recente
sonnet (alias)	200k	64k	Sempre o Sonnet mais recente
haiku (alias)	200k	32k	Sempre o Haiku mais recente
claude-fable-5	1M	128k	Mais poderoso (tier acima do Opus)
claude-opus-4-8	1M	128k	Mais capaz, atual
claude-opus-4-7	1M	64k	Anterior
claude-opus-4-5	200k	64k	Legado
claude-sonnet-4-6	200k	64k	Equilibrado, atual
claude-haiku-4-5-20251001	200k	32k	Rápido e barato

Tem opção de digitar ID custom se quiser fixar uma versão específica.

📌 Padrão de novas sessões: claude-opus-4-8 (1M tokens de contexto, 128k de saída). Mude pelo dropdown se preferir outro.

📎 Anexar arquivos

Botão @ ao lado da caixa de prompt. Abre o file picker nativo do Windows/Mac/Linux com multi-seleção. Os caminhos são inseridos no prompt como @arquivo.txt @outro.md.

O Claude Code entende a sintaxe @caminho nativamente — quando ele vê isso no prompt, lê o arquivo automaticamente.

💡 Caminhos dentro da pasta de trabalho viram relativos (mais limpos). Fora viram absolutos.

🤖 Auto-compact em 95%

Quando o uso de contexto da sessão atinge 95% da janela do modelo (190k tokens em modelos 200k, 950k em modelos 1M), a extensão enfileira automaticamente um /compact com prioridade.

O /compact vai pra frente da fila e roda primeiro
Suas próximas mensagens esperam ele terminar
Depois o contexto cai (geralmente pra 30–40%) e processa normalmente
Você economiza tokens (cada turno re-envia o histórico inteiro via --resume)

Tem proteção anti-loop: se o /compact não baixar o uso, ele não dispara de novo.

🛡️ Bypass permissions

Toggle no rodapé esquerdo. Quando ATIVO (vermelho):

O Claude pode usar ferramentas de escrita (Edit, Write, Bash) sem perguntar
Mais rápido pra trabalhos longos
Mais perigoso (pode escrever onde não deveria)

Quando desativado, perguntas de permissão são bloqueadas (ainda em desenvolvimento — vai pra acceptEdits por padrão).

📊 Tracking de tokens e custo

Donut no rodapé direito mostra:

% restante até auto-compact com cor (verde/amarelo/vermelho)
↑ tokens enviados (input novo + cache write)
↓ tokens recebidos (output)
✓ cache lido (re-aproveitado, custa 10% do input normal)
$custo acumulado USD

Hover no donut mostra tooltip detalhado com:

ID da sessão Claude (UUID)
Modelo em uso
Contexto deste turno X/Y (Z%)
Total enviado/recebido/cache/custo desta sessão
Explicação de por que parece muito (system prompt + histórico)

Botão direito no donut: opção de resetar contadores desta sessão.

✏️ Editar mensagem do usuário

Hover sobre uma mensagem VOCÊ mostra ícones:

⧉ copiar
✎ editar e reenviar — abre textarea inline, Ctrl+Enter envia, Esc cancela. A mensagem original é removida do transcript e o novo texto vai pra fila com prioridade.

💡 O contexto do Claude (--resume) ainda contém a mensagem original — mas o chat na UI mostra só a nova versão.

📋 Copiar respostas do Claude

Hover sobre uma mensagem CLAUDE mostra borda roxa + ícone ⧉ copiar. Clica e o texto vai pro clipboard.

🖱️ Layout customizável

Coluna esquerda (sessões + fila): arraste o divisor laranja vertical pra ajustar largura. Clique duplo reseta.
Caixa de prompt: arraste o divisor horizontal acima dela pra crescer/encolher (útil pra prompts multi-linha). Clique duplo reseta.
Larguras persistem em localStorage — sobrevivem a reload.

📁 Isolamento por workspace

Sessões são filtradas pela pasta atualmente aberta no VSCode — casada de forma exata, do mesmo jeito que o Claude Code separa projetos por diretório. Sessões criadas em outras pastas (inclusive em subpastas da pasta aberta) ficam ocultas até você abrir aquela pasta exata. O isolamento é sempre ligado; pra ver uma sessão, abra a pasta em que ela foi criada.

🧠 BI de prompts — auto-planejamento com `/goal` e `/agents`

Abra o chip BI no header (ao lado de model/effort) e você vê dois radios independentes — Goal e Agents — cada um com três estados: off, check, force. Tem também um toggle Revisão automática ao final.

Modo	O que faz
off	Prompt vai cru pro Claude — comportamento padrão sem BI
check	Antes de executar, Claude gera um plano e o PlanApprovalModal abre com Aprovar / Rejeitar / Reprocessar (com textarea de observação). Só executa depois que você aprova.
force	Prompt é prefixado automaticamente (com `/goal` e/ou `/agents`) e Claude executa direto com uma checklist ao vivo mostrando cada etapa

Quando pelo menos um modo está ativo, todo prompt daquela sessão passa pela BI. O badge BI g:c a:f no header mostra o estado atual de relance.

Popup de aprovação (modo check):

Lista enumerada com título + subtítulo curto + subagente sugerido
Aprovar → executa com o plano combinado
Rejeitar → cancela o item inteiro
Reprocessar → textarea onde você descreve o que mudar ("quebra o passo 3 em dois", "remove o passo 5"), Claude gera plano novo com sua observação incorporada. Durante a regeneração, o PlanChecklist mostra "Regenerando plano com suas observações…" com badge pulsante.

📋 PlanChecklist (fixo no topo)

Sempre que um plano está anexado a um item da fila (check aprovado OU force), um painel fixo renderiza no topo do chat com header Plano · X/Y e as etapas enumeradas.

Estados ao vivo: ⏳ na fila · ▶ executando (laranja, pulsando) · ✓ feito · ✗ falhou · ⊘ não executado (preenchido pela auto-revisão)
▾ colapsa só a lista (header continua)
✕ oculta tudo → faixa fina "Plano oculto · X/Y · mostrar" com bolinha pulsante quando há trabalho em andamento. Clique na faixa pra trazer de volta. A flag de ocultar é por item, então reprocessar reabre fresco.
Botão Cancelar restante (N) enquanto executa — mata o processo; etapas pendentes não rodam
Clique num passo ✓ pra pular no chat pra onde ele rodou (casado por queueItemId)
Permanece no histórico depois que termina, pra você revisitar

🔁 Revisão automática ao final

Quando um plano termina de executar e Revisão automática ao final está ligada (default), a extensão dispara mais um turno --resume pedindo que o Claude verifique cada etapa com evidência concreta (arquivo, comando, trecho).

Etapas com evidência → ficam ✓
Etapas sem evidência → ⊘ "não executado" (amarelo, tooltip mostra o motivo)
Se houver algum ⊘, um PlanFollowupModal abre com checklist das etapas pendentes e pergunta: "Executar selecionadas (N)" / "Não, deixar como está"
Marcar "sim" enfileira um prompt focado pedindo que o Claude rode exatamente as etapas selecionadas

Enquanto o turno de revisão roda, o PlanChecklist mostra "Revisando — verificando evidência por etapa…" com badge pulsante.

📥 `/import @arquivo.md` — enfileirar em massa a partir de Markdown

Digite /import @arquivo.md (ou /import path/para/arquivo.md) na caixa de prompt. O ClaudeQueue intercepta o comando, lê o arquivo, e abre um ImportPreviewModal listando toda tarefa executável detectada.

Parser: por padrão usa Haiku one-shot (claudequeue.importParserModel: "smart") — melhor pra docs com bastante prosa. Cai pra heurística pura em JS (## headings, - [ ] task list, 1. 2. 3. listas numeradas) se Haiku indisponível. Configure pra "regex" pra forçar modo offline.
Cada tarefa detectada mostra: id, título (máx 6 palavras), subtítulo curto, conteúdo expansível
Marca/desmarca pra controlar o que enfileira (começa tudo selecionado)
Confirma → cada item vira uma entrada separada na fila que roda serialmente no mesmo --resume, preservando contexto entre tarefas
Combine com os modos BI: importar 15 tarefas numa sessão com Agents: force delega cada uma a subagentes automaticamente

🔄 Recovery após reload

Se você reload a janela do VSCode (ou ela trava e você reabre):

Itens em FILA continuam na fila
Item que estava RODANDO volta pra FILA no início (re-executa do zero)
Itens já FEITO/PARADO/ERRO ficam preservados no histórico

Tudo que você não cancelou explicitamente continua de onde parou.

Atalhos de teclado

Tecla	Ação
`Ctrl+Alt+C`	Abrir painel ClaudeQueue
`Ctrl+Alt+N`	Nova sessão
`Ctrl+Alt+Enter`	Enviar seleção do editor como prompt
`Enter`	Enfileirar prompt
`Ctrl+Enter`	Enfileirar com prioridade (vai pra frente da fila)
`Ctrl+Shift+Enter`	Broadcast em todas as sessões
`Shift+J` / `Shift+K`	Reordenar item selecionado da fila ↓/↑
`Del`	Cancelar item selecionado
`E`	Editar prompt (só itens enfileirados)
`R`	Re-enfileirar item finalizado
`Ctrl+F`	Buscar nas mensagens da sessão

Configurações

Todas começam com claudequeue.:

Chave	Default	Descrição
`binaryPath`	`""`	Caminho explícito do `claude` (vazio = auto-detect)
`defaultPermissionMode`	`acceptEdits`	`default`, `acceptEdits` ou `bypassPermissions`
`allowBypass`	`true`	Mostra toggle "Bypass permissions" no rodapé
`autoDetectQuestions`	`false`	Destaca respostas terminando em `?`
`maxParallelWarning`	`5`	Aviso ao passar deste número de sessões em paralelo
`statusIdleThresholdMs`	`800`	Mostra "Wandering..." após Xms sem novo token
`brokerTimeoutSeconds`	`300`	Timeout do prompt de permissão (auto-deny)
`notifyOnFinish`	`true`	Status bar avisa quando item termina
`workspaceIsolation`	`true`	Sessões são isoladas por pasta com match exato de cwd (subpastas excluídas). O isolamento é sempre ligado.
`importParserModel`	`smart`	Parser do `/import @arquivo.md`: `smart` (Haiku one-shot) ou `regex` (só offline)

Workflows comuns

"Quero refatorar 10 arquivos seguidos sem ter que ficar olhando"

Cria uma sessão, modelo Opus 4.8
Ativa Bypass permissions (rodapé)
Manda 10 prompts em sequência (Enter entre cada): "refatora @arquivo1.ts ...", "agora @arquivo2.ts ...", etc.
Vai fazer outra coisa. Cada item processa serial, salvando os arquivos.
Quando voltar, todos terminaram. Confere o transcript.

"Quero comparar a mesma pergunta em modelos diferentes"

Cria 3 sessões, cada uma com modelo diferente (Opus 4.8, Sonnet 4.6, Haiku 4.5)
Foca uma sessão, manda o prompt
Foca a próxima, manda o mesmo prompt
(ou usa Ctrl+Shift+Enter pra mandar o mesmo prompt em TODAS de uma vez)
Compara as respostas

"Quero rodar o mesmo prompt 50 vezes pra testar consistência"

Manda o prompt uma vez
Quando terminar, botão direito → Multi-processar... → digita 50
As 50 cópias entram na fila
Vai tomar café — leva uns minutos

"Sessão tá pesada (200k tokens, custo subindo)"

Espera o auto-compact disparar em 95%
OU manda manualmente um prompt /compact (ele resume a conversa e baixa o contexto)
OU cria nova sessão pro próximo assunto (recomendado pra trocar de domínio)
OU clica botão direito no donut do rodapé → Resetar contadores (limpa a estatística mas não muda o contexto real do Claude)

Privacidade & custo

Todas as conversas passam pelo seu claude CLI local indo pra API da Anthropic — exatamente igual a usar Claude Code direto no terminal
Custos e tokens são mostrados por sessão no rodapé
Cada turno re-envia o histórico (comportamento normal do Claude Code via --resume, não é peculiaridade desta extensão)
O auto-compact em 95% reduz contexto pra economizar
Os dados ficam no seu disco local em globalStorage da extensão (SQLite). Nada é enviado a outro servidor além do que vai pra Anthropic via o CLI oficial.

Onde os dados ficam salvos

Tudo vai pra globalStorage da extensão no VSCode:

Windows: C:\Users\<você>\AppData\Roaming\Code\User\globalStorage\danielrafaelramos.claudequeue\
macOS: ~/Library/Application Support/Code/User/globalStorage/danielrafaelramos.claudequeue/
Linux: ~/.config/Code/User/globalStorage/danielrafaelramos.claudequeue/

O arquivo principal é state.db (SQLite). Você pode deletar pra resetar tudo (perde sessões e transcript).

Licença

MIT — veja o arquivo LICENSE no repositório.

ClaudeQueue

daniel rafael ramos

ClaudeQueue

🇺🇸 English

⚠️ Important: requires a paid Anthropic plan

Features

Prerequisites

1. VSCode 1.85 or higher

2. Node.js 18 or higher

3. Claude Code CLI installed

4. Authentication on Claude

Getting started

Detailed guide for each feature

🗂️ Sessions

📥 Prompt queue

🔍 Message search

🤖 Model selection

📎 Attach files

🤖 Auto-compact at 95%

🛡️ Bypass permissions

📊 Token and cost tracking

✏️ Edit user message

📋 Copy Claude responses

🖱️ Customizable layout

📁 Workspace isolation

🧠 Prompt BI — auto-planning with /goal and /agents

📋 PlanChecklist (sticky on top)

🔁 Auto-review at the end

📥 /import @file.md — bulk-enqueue from Markdown

🔄 Recovery after reload

Keyboard shortcuts

Settings

Common workflows

"I want to refactor 10 files in a row without having to keep watching"

"I want to compare the same question across different models"

"I want to run the same prompt 50 times to test consistency"

"Session is heavy (200k tokens, cost climbing)"

Privacy & cost

Where data is saved

License

🇧🇷 Português

⚠️ Importante: precisa de plano pago da Anthropic

Funcionalidades

Pré-requisitos

1. VSCode 1.85 ou superior

2. Node.js 18 ou superior

3. Claude Code CLI instalado

4. Autenticação no Claude

Como começar

Guia detalhado de cada funcionalidade

🗂️ Sessões

📥 Fila de prompts

🔍 Busca nas mensagens

🤖 Seleção de modelo

📎 Anexar arquivos

🤖 Auto-compact em 95%

🛡️ Bypass permissions

📊 Tracking de tokens e custo

✏️ Editar mensagem do usuário

📋 Copiar respostas do Claude

🖱️ Layout customizável

📁 Isolamento por workspace

🧠 BI de prompts — auto-planejamento com /goal e /agents

📋 PlanChecklist (fixo no topo)

🔁 Revisão automática ao final

📥 /import @arquivo.md — enfileirar em massa a partir de Markdown

🔄 Recovery após reload

Atalhos de teclado

Configurações

Workflows comuns

"Quero refatorar 10 arquivos seguidos sem ter que ficar olhando"

"Quero comparar a mesma pergunta em modelos diferentes"

"Quero rodar o mesmo prompt 50 vezes pra testar consistência"

"Sessão tá pesada (200k tokens, custo subindo)"

Privacidade & custo

Onde os dados ficam salvos

Licença

🧠 Prompt BI — auto-planning with `/goal` and `/agents`

📥 `/import @file.md` — bulk-enqueue from Markdown

🧠 BI de prompts — auto-planejamento com `/goal` e `/agents`

📥 `/import @arquivo.md` — enfileirar em massa a partir de Markdown