PlanQueue

Rodar mais de uma sessão de coding agent ao mesmo tempo significa lembrar o que cada terminal está tentando fazer. O plano fica na sua cabeça, ou num arquivo que você mantém do lado, e o prompt seguinte exige abrir o arquivo certo, achar o passo, selecionar a linha com o mouse, copiar, trocar de janela e colar no agente. Cada ação é pequena. Repetida a cada passo, em cada sessão, quebra o flow.

Eu cheguei a rodar de 10 a 20 sessões assim, com um Markdown ao lado de cada terminal, e testei várias variações da mesma ideia antes desta. A causa raiz era sempre a mesma: o plano e a sessão eram dois artefatos separados. A cada viagem entre eles, um pedaço do plano se perdia, e o resto ficava na cabeça em vez de em texto.

O PlanQueue elimina essa transcrição. É um plugin MIT para Oh My Pi (OMP), um harness de terminal para coding agents. Ele renderiza uma nota de sessão abaixo da status line e roda essa mesma nota como fila de prompts. A nota que você lê é a nota que você roda.

Cada linha de topo é uma tarefa em checkbox markdown: pendente, em execução, concluída. Ctrl+Baixo despacha a próxima linha para o agente; linhas indentadas abaixo dela vão juntas, como um prompt multi-linha. Ctrl+Shift+Baixo liga o auto-run, que consome uma tarefa por vez enquanto você faz outra coisa.

Uma linha só com três traços (---) é um checkpoint humano: o auto-run para ali e espera você revisar. Coloque um antes de qualquer passo irreversível e o resto anda sozinho. Você escreve o caminho inteiro enquanto a ideia está clara e define exatamente onde o agente tem que parar e esperar.

A parte que eu não planejei e mais uso: o próprio agente escreve a fila. Diga "adiciona na lista" no meio da conversa e ele acrescenta uma tarefa. /make-note decompõe um objetivo em uma fila pronta para rodar, com checkpoints incluídos. /rebuild-note replaneja a partir da sessão inteira, mantendo só o que ainda falta.

Tudo é Markdown puro, por repositório, branch e sessão, em ~/.planqueue, com um histórico append-only ao lado. Sem banco, sem app separado. /planqueue navega as notas de sessões paralelas do mesmo repo e branch. A lógica pura (caminhos, fila, editor, config) foi extraída no pacote @aryrabelo/planqueue-core, testável com bun test e usável fora do OMP.

O limite honesto: o OMP limita cadeias de continuação a 8, então um auto-run sem checkpoint pausa depois de mais ou menos 8 tarefas, e também pausa em erro. A visão de frota entre vários workspaces vem da combinação com o Herdr. O objetivo nunca foi tirar você do trabalho. É tirar o caminho da sua cabeça e colocar sua atenção onde uma decisão é necessária.

Instale com omp plugin install github:aryrabelo/planqueue.