Aprenda o monoban em dez minutos.

Seis palavras para saber

projeto

Um quadro próprio, com uma chave curta como SHOP. Cada tarefa dele leva esse nome.

coluna

Uma etapa por onde o trabalho passa. Projetos novos vêm com Backlog, A fazer, Em andamento e Concluído.

tarefa

Um título e uma descrição em Markdown, com um nome como SHOP-14. Etiquetas, links, um dia, comentários.

etiqueta

Um rótulo como bug ou phase-1, de um só projeto ou compartilhado por todos.

runner

O monoban runner, rodando num terminal na sua máquina: ele pega as tarefas que você entrega aos agentes.

execução

Uma rodada de um agente numa tarefa: os passos, o que ele está fazendo agora e o pull request que ele abre.

Por onde começar

• Quero um quadro tranquilo para o meu trabalhoLeia o 01 e o 02. Dez minutos, e a demo ao vivo para experimentar. →
• Eu vivo no terminalO 03 configura a CLI e mostra o dia a dia. →
• Trabalho com agentes de código04 e 05: agentes que planejam no quadro, e agentes que fazem as tarefas. →

Seu primeiro quadro em um minuto

1. Entre

   Com o Google, com seu e-mail e senha, ou peça um link de uso único por e-mail. O Google serve para uma conta com o mesmo endereço. Ainda sem senha? O esqueceu? da página de entrada manda por e-mail um link para você escolher uma, e Configurações › Entrada a troca. Uma senha nova não desconecta a CLI nem encerra os tokens pessoais, então, se sobrar algum, perguntamos se você quer mantê-los ou revogá-los.

2. Crie um projeto

   Dê um nome a ele. Ele começa com Backlog, A fazer, Em andamento e Concluído, e depois você pode renomear, reordenar ou adicionar colunas. A chave dele (SHOP) dá nome a cada tarefa: SHOP-1, SHOP-2…

3. Adicione tarefas com n

   Digite um título e aperte ↵. O campo continua aberto para a próxima, então você esvazia a cabeça de uma vez. esc quando terminar.

4. Ande pelo quadro, mova tarefas

   j k selecionam uma tarefa, h l mudam de coluna (as setas também). Some ⇧ para levar a tarefa junto: ⇧→ a move para a próxima coluna, ⇧↑ a reordena, e ⌘⇧↑ a manda para o topo da coluna (⌘⇧↓: para o fim; o painel da tarefa também tem um botão). Arrastar também funciona.

5. Abra uma com ↵

   Ela abre ao lado do quadro, como uma aba no seu editor. j e k continuam passando pelas tarefas com ela aberta, z a alarga, esc a fecha.

Dentro de uma tarefa

A descrição é Markdown. Linhas que começam com - [ ] são uma lista de verificação, e o cartão mostra quanto dela já foi feito ([2/5]). ⇥ recua as linhas selecionadas e ⇧⇥ desfaz o recuo, aqui e nas notas. Em volta dela, uma tecla para cada coisa:

Mantenha tudo em ordem

Instale

O Homebrew instala um binário independente para macOS e Linux, com o autocompletar incluído (sem precisar de Node). O npm precisa do Node 22.12 ou mais novo.

Configure uma vez

1. monoban login

   Ele abre o navegador para você aprovar a entrada. Por SSH, monoban login --device dá um código para você digitar. Cada entrada nova é avisada por e-mail, e em Configurações você desconecta qualquer computador.

2. monoban link SHOP

   Rode no seu clone. Daí em diante, os comandos ali usam o projeto SHOP, e o projeto fica sabendo qual é o repositório dele no GitHub. Em outros lugares, -p SHOP escolhe o projeto.

3. monoban doctor

   Confere esta máquina: sua versão, a entrada, o git e o gh, e os agentes de código. O que estiver faltando, ele diz como resolver.

O dia a dia

$ monoban add "Fix the flaky checkout test" -t bug  # SHOP-14, no fim da primeira coluna$ monoban list  # o quadro, coluna por coluna$ monoban start SHOP-14  # faz checkout de shop-14-fix-the-flaky-checkout-test, move para Em andamento# …trabalho, commit, gh pr create…$ monoban attach --pr  # o pull request deste branch, no cartão$ monoban done SHOP-14  # e ela está em Concluído

Mais coisas que dá para fazer

Some --help a qualquer comando para ver o resto.

Scripts e CI

Todo comando aceita --json. Os resultados vão para o stdout e as mensagens para o stderr, e o código de saída diz o que aconteceu: 0 ok, 1 erro, 2 uso, 4 sem entrar, 5 não encontrado. Na CI, entre com um token de acesso pessoal de Configurações (só leitura, ou leitura e escrita) em MONOBAN_TOKEN.

O caminho de uma execução

1. 1vocêAperte R. Escolha o runner, o agente e a pasta do seu clone. A execução entra na fila.
2. 2runnerPega a tarefa. Em até um minuto: parado, ele verifica uma vez por minuto. Confere se a pasta é um clone do projeto da tarefa, sem nada por commitar.
3. 3prepareUm branch. Busca o branch padrão, faz checkout de shop-14-fix-the-flaky-checkout-test, move a tarefa para Em andamento.
4. 4codeO agente trabalha. Ele recebe a tarefa: título, descrição e os últimos comentários. A aba de execução mostra o que ele está fazendo agora.
5. 5commit · push · prUm pull request. O que ele deixou entra num commit e é enviado, e o gh abre o pull request (um rascunho, a menos que você tenha pedido pronto).
6. 6reportDe volta à tarefa. O pull request é anexado à tarefa, com um comentário dizendo o que foi feito.

Isso no Claude Code e no Codex: o runner faz o trabalho de git em volta deles, e eles só escrevem o código. O agentpipe faz o seu: ele planeja, implementa e verifica em passos próprios, e move e comenta a tarefa pelo caminho.

Sua primeira execução

1. Instale um agente onde está o código

   agentpipe	monoban agentpipe install
   Claude Code	npm install -g @anthropic-ai/claude-code
   Codex	npm install -g @openai/codex

   Para os pull requests, o runner usa o gh do GitHub, com a sua conta (gh auth login). O monoban doctor diz o que está faltando.

2. Inicie o runner, e deixe-o rodando

   $monoban runnercopy

   A luz do runner na barra de status fica verde, e Configurações o lista. Ele oferece os agentes que encontra, e percebe em até um minuto um que você instalar depois.

3. Tenha um clone limpo do projeto

   Uma execução só roda num checkout do projeto da tarefa: o origin dele é o repositório vinculado ao projeto, ou você rodou monoban link ali. No Claude Code e no Codex, ele não pode ter mudanças sem commit.

4. Aperte R numa tarefa

   Runner	a máquina; as online vêm primeiro
   Agente	os que aquele runner tem; a janela diz como instalar os outros
   Pasta no runner	o caminho absoluto do seu clone, lembrado para o projeto neste dispositivo
   Pull request	um rascunho (o padrão), pronto para revisão, ou nenhum: só o branch
   Orçamento (US$)	o máximo que ele pode gastar, em dólares americanos (agentpipe, Claude Code)
   Modelo	qual modelo, com o nome que o agente usa (Claude Code, Codex)
   Acesso	só no Codex: o sandbox dele, o sandbox com rede, ou sem sandbox

5. Acompanhe com w

   A aba de execução se atualiza a cada dois segundos, mais ou menos. Cancelar a interrompe, e o que ela já fez fica guardado.

Como uma execução termina

Pelo terminal

$ monoban run SHOP-14 --agent claude --follow  # põe na fila aqui, mostra os passos até ela terminar$ monoban runs SHOP-14  # as execuções dela, as mais novas primeiro

Você continua no controle

O que continua funcionando

Leia a barra de status

sincronizado

Tudo o que você fez está no servidor.

salvando…

Uma mudança está a caminho.

offline · 3 alterações

Sem conexão. Três mudanças esperam neste dispositivo e saem, em ordem, quando ela voltar.

1 alteração não aplicada

Recusada: alterada ou excluída em outro lugar nesse meio-tempo. Clique para ver o porquê, copiar o que você escreveu ou descartar.

Clique nela, ou aperte O, para um cartão com a situação: offline desde quando, o que está esperando, e quantos quadros e cópias de páginas este navegador guarda. Ele abre offline também.

Uma tarefa que você adiciona offline mostra a referência apagada e inclinada, como um palpite: até o servidor dar o número dela, a CLI ou outro dispositivo podem ficar com esse primeiro.

Quando algo mudou em outro lugar

Você trabalhou offline enquanto a CLI, a execução de um agente ou o seu outro notebook mudava a mesma tarefa. Quando a sua mudança sai, o monoban a junta campo a campo: o que só você mudou entra, e o que só eles mudaram fica. Onde os dois mudaram, fica a versão deles, e as suas palavras nunca se perdem: a sua descrição é guardada com a deles embaixo, e o seu título vai para a descrição, sob uma linha dizendo que ele mudou em outro lugar ao mesmo tempo. Um aviso diz o que aconteceu.

Uma mudança numa tarefa excluída em outro lugar não tem como entrar. Ela espera em não aplicadas (a barra de status, ou ⌘K › Mudanças não aplicadas), onde você pode copiar o que escreveu, ou descartar.

Duas abas, ou mais

Cada aba envia as próprias mudanças. Se você fechar uma antes de as mudanças dela saírem, outra aba aberta as envia na hora, e uma mudança salva numa aba aparece nas outras sem recarregar.

O que este navegador guarda

Configurações › Este navegador mostra: os quadros que você abriu aqui (cada um sai 7 dias depois da última vez que você o abriu), as mudanças esperando, as cópias de páginas que abrem sem rede, e suas preferências. Nunca um token, uma senha ou as suas notas: offline, só as linhas que você adiciona a elas esperam aqui.

Remover o que está guardado apaga tudo isso e mantém você conectado; os quadros voltam conforme você os abre, e suas preferências ficam. Com mudanças ainda não enviadas, ele pergunta antes: elas vão junto.

No terminal