Verboo Code: como acompanhar tarefas em background com /tasks
Voltar para o Blog
Artigoverboo codetutorialdev toolsprodutividade

Verboo Code: como acompanhar tarefas em background com /tasks

Mafra13 de novembro de 20266 min de leitura

Você manda o build rodar, abre outro arquivo e continua trabalhando. Meia hora depois não lembra mais o que ficou em segundo plano, nem se ainda está rodando. O /tasks é o painel que responde isso dentro da Verboo Code: o que está ativo agora, em que estado, e qual tecla para o que travou.

Este guia cobre o comando, as teclas do painel, o arquivo onde a saída fica e o motivo mais comum de uma tarefa parecer travada. Tudo conferido no código-fonte de verbeux-ai/code, versão 0.15.41, em 13/11/2026.

O que o /tasks mostra?

Mostra apenas as tarefas que ainda estão rodando ou na fila. Tarefa concluída, que falhou ou que você parou sai da lista imediatamente, mesmo que você abra o painel um segundo depois do fim.

O filtro é explícito no código (src/tasks/types.ts): só entra na lista o que tem status running ou pending. O cabeçalho do painel resume o total, no formato 2 agents · 1 active shell · 3 active agents, e cada linha mostra o status e a atividade mais recente da tarefa.

Quais tipos de tarefa aparecem?

O painel separa por seção, e cada tipo tem uma origem diferente:

TipoComo nasceO que a linha mostra
Shellcomando longo em segundo planoo comando executado
Agente localsubagente disparado em segundo planoa descrição da tarefa
Sessão remotasessão em nuvemo título da sessão
Agente de equipeagente rodando no mesmo processoo @nome do agente
Workflowworkflow em segundo planoo resumo do workflow
Monitorferramenta Monitor acompanhando um loga descrição do que está sendo observado

Agentes de equipe aparecem agrupados por time, com o líder no topo e cada integrante abaixo. É a mesma lista que alimenta o indicador do rodapé, aquele que mostra 1 shell ou 2 local agents enquanto você digita.

Como abrir o painel?

Digite /tasks no prompt. O comando também atende pelo apelido /bashes, herdado da época em que só existiam shells.

/tasks

Com uma única tarefa ativa, o painel pula a lista e abre direto o detalhe dela. Com nenhuma, mostra No tasks currently running. O painel lê o estado da sessão atual, então ele nunca mostra tarefa de outra sessão sua.

Quais teclas funcionam no painel?

São poucas e todas aparecem na própria tela:

TeclaAção
↑ / ↓move a seleção
Enterabre o detalhe da tarefa
xpara a tarefa selecionada
fentra na visão do agente de equipe
← ou Escfecha o painel
ctrl+x ctrl+kpara todos os agentes locais em execução

O x só aparece quando a tarefa selecionada está de fato rodando. No detalhe, você vê a saída acumulada e o status ao vivo, sem precisar sair do painel.

Como colocar uma tarefa em segundo plano?

Dois caminhos. Pelo teclado, com um comando rodando em primeiro plano, ctrl+b manda ele para o fundo e devolve o prompt. Pelo agente, o mesmo acontece quando ele chama o Bash com run_in_background: true, ou quando dispara um subagente ou um Monitor.

O sleep é o único comando que o código exclui do segundo plano automático (src/tools/BashTool/BashTool.tsx): quem pede uma pausa quer a pausa, não um processo solto. Se você pedir explicitamente, ele vai para o fundo como qualquer outro.

Uma variável desliga o recurso inteiro: com CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ligada, o parâmetro run_in_background nem aparece no schema da ferramenta, e o ctrl+b deixa de responder.

Onde fica a saída de cada tarefa?

Cada tarefa grava num arquivo <taskId>.output, dentro de tasks/ na pasta temporária do projeto, em um diretório por sessão. O caminho aparece no resultado da ferramenta e volta em cada notificação de conclusão, então basta apontar o Read para ele.

/tmp/claude-{uid}/{projeto}/{sessionId}/tasks/{taskId}.output

O arquivo continua no disco depois que a tarefa termina. É por isso que vale anotar o caminho: quando a tarefa sai do /tasks, o arquivo é o único lugar onde a saída ainda está. A ferramenta TaskOutput ainda existe, mas está marcada como depreciada no código, justamente em favor da leitura direta do arquivo.

Por que a tarefa travou esperando resposta?

Porque o comando pediu uma confirmação interativa e não tem ninguém para responder. Um comando em segundo plano não recebe entrada, então um (y/n) no meio da execução deixa o processo parado para sempre.

A Verboo Code detecta isso. Um verificador confere o tamanho do arquivo de saída a cada 5 segundos e, se ele ficar 45 segundos sem crescer e a última linha parecer um prompt interativo ((y/n), [Y/n], Press Enter, uma pergunta terminando em ?), dispara uma notificação dizendo que a tarefa parece esperando entrada.

O conserto é matar a tarefa com x e rodar de novo com a resposta canalizada ou com a flag não interativa do programa:

echo y | npm run db:migrate

O mesmo vale para instaladores, CLIs de nuvem e qualquer coisa que abra um menu. Na dúvida, teste o comando em primeiro plano uma vez antes de mandar para o fundo.

Armadilha no tmux. Dentro do tmux, ctrl+b é o prefixo do próprio tmux e não chega na Verboo Code. O código trata isso: a dica na tela passa a pedir ctrl+b ctrl+b. Se continuar confuso, use /tasks, que não depende de tecla nenhuma.

Fluxograma: mandar a tarefa para o fundo com ctrl+b, abrir o painel com /tasks, ver a saída com Enter e parar com x. O ramo mostra o caso de comando travado esperando confirmação.
Do comando ao painel: o caminho normal e o ramo de comando travado esperando entrada interativa.

Vale deixar tarefa rodando em segundo plano?

Vale quando a tarefa é longa e não precisa da sua decisão no meio: suíte de testes, build, instalação de dependência, migração. Você ganha o tempo de volta e recebe uma notificação no fim.

Não vale para o que pede confirmação, para o que depende de variável de ambiente que só existe no seu shell interativo, nem para comando que imprime muita coisa: o arquivo de saída tem teto de 5 GB, e acima disso a gravação é interrompida.

O painel só mostra o que está rodando agora, então o hábito certo é abrir /tasks antes de fechar a sessão. Se você ainda não usa segundo plano no dia a dia, comece por um caso só: mande o build rodar, toque ctrl+b e siga no arquivo seguinte. Na Verboo Code o token é ilimitado, então uma tarefa de fundo não come a cota que você vai precisar depois. A conta sai em verboo.ai.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados