🧵 Time em segundo plano

Nos vídeos de mods, várias sessões do Claude trabalhavam juntas, com um painel mostrando quem estava ativo e quem tinha travado. Era feito por engenharia reversa e quebrava a cada atualização.

Hoje o próprio Claude Code faz isso pela via oficial: claude --bg solta uma sessão que trabalha sozinha, sem prender o seu terminal. Por baixo, o Claude lista essas sessões com claude agents. O kit embrulha a leitura dessa lista num script curto, o observar.mjs.

Como ler o desenho: as setas roxas são os comandos que você dá. As caixas azuis são as sessões trabalhando sozinhas, lado a lado. O observar.mjs só olha: ele não para nem altera nenhuma sessão.

Uma sessão em segundo plano trabalha sem você olhando. Por isso o Claude só aceita soltá-la numa pasta que você já disse que confia. É um passo único por pasta.

Sem esse passo, o --bg responde Workspace not trusted e não faz nada. A receita R4 começa exatamente por aqui.

claude

"No, exit"                       ← vem selecionado: NÃO aperte Enter aqui
"Yes, I trust this folder"       ← escolha esta

A receita R4 solta duas sessões. Um revisor que só lê e responde uma pergunta sobre a POLITICA. E um executor, num modelo mais leve, que cria um arquivo.

Cada linha devolve o terminal na hora. As duas sessões seguem trabalhando sozinhas, ao mesmo tempo.

claude --bg --permission-mode plan --name revisor "Leia runtime/POLITICA.md e responda em uma linha qual é o teto de 'Enviar'."
claude --bg --model sonnet --name executor "Crie resumo.md com 3 linhas sobre o que é este kit."

sessão listada como background … done; respondeu "N2" lendo a POLITICA

O que olhar na tabela: o modo e o modelo seguem as regras do ROTEAMENTO.md e da POLITICA.md que você viu no módulo 3.1. Quem só lê, roda em modo plano. Quem faz pouco, roda no menor que resolve.

O runtime/scripts/observar.mjs mostra numa tabela as sessões em segundo plano desta pasta. Ele só lê a lista que o Claude devolve em claude agents --json. Não para nem altera sessão nenhuma.

Rode quantas vezes quiser: não chama modelo e não gasta cota.

node runtime/scripts/observar.mjs

id        tipo        nome        estado  iniciada há
d6816239  background  r4-revisor  done    7 min

ver saída: claude logs <id> · entrar: claude attach <id> · parar: claude stop <id>

Como ler o desenho: o caminho bom vai da esquerda para a direita até done. As linhas tracejadas vermelhas são os desvios: uma sessão pode travar esperando uma permissão (blocked) ou falhar (failed). Nos dois casos, é com você.

O próprio rodapé do observar lembra os três comandos. Todos usam o id da primeira coluna da tabela, por exemplo d6816239.

Ler é sempre seguro. Entrar serve para destravar uma sessão blocked. Parar é a saída quando ela gasta cota sem chegar a lugar nenhum.

O que olhar na tabela: troque <id> pelo código que o observar mostrou. Sem os sinais de menor e maior.

claude logs <id>

o revisor respondeu "N2" lendo a POLITICA

Cada sessão grava o resultado em arquivo, como o resumo.md do executor. No fim, uma sessão "chefe" (ou o time da R2) lê esses arquivos e consolida numa resposta só.

O cuidado é a cota: cada sessão consome a da sua assinatura. A própria R4 avisa: comece pela R2, que roda numa sessão só, e solte sessões paralelas quando o ganho de tempo compensar.

Use o time (planejador, executor, revisor) para ler resumo.md, conferir se ele tem 3 linhas sobre o que é este kit e me dizer APROVADO ou o que falta. Não altere outros arquivos.

O que olhar na tabela: é a regra 2 do ROTEAMENTO.md na prática. Time de agentes só quando o trabalho é maior que o custo de montar o time.