CLI — agentop

O agentop é um binário único. A referência completa está sempre em:

agentop --help
agentop --version

O cockpit

agentop                  # abre o cockpit (o mesmo que agentop start)
agentop start --lang pt  # força português nesta execução
agentop tui              # apelido de agentop start

Abas, na ordem: Serviços, Sessões, Backup, a aba de métricas, Hardware, Logs, Comandos, Ajuda e Contribuir. A aba de métricas funciona sem navegador e tem as telas Overview, Projects, History, Costs, Harnesses e Hardware, trocadas com 1 a 6; f filtra por harness.

Tecla	Faz
← / →	troca de aba
tab	troca de painel
enter	ações da linha selecionada
q	sai

Sem um terminal interativo (um pipe, uma unit do systemd), o agentop se comporta como agentop server.

Servidor local

agentop server              # web em :47292, API e MCP em :47291
agentop server --port 4000  # API na 4000, web na 4001
agentop server --bg         # em segundo plano, logs em ~/.agentistics
agentop status              # serviços e saúde, sem abrir nada
agentop restart             # reinicia o serviço instalado pelo autostart
agentop watch               # só o daemon de métricas OpenTelemetry

Sessões

As sessões em segundo plano rodam no tmux, num socket próprio (-L agentop): sobrevivem ao agentop fechar e não se misturam com as suas sessões de tmux.

agentop session <harness> [-p "prompt"] [--bg] [--model <id>] [--effort <nível>] [--cwd <pasta>] [--name "rótulo"] [--task "<nome>"]
agentop session ls [--all] [--group <dimensão>] [--json]
agentop session attach <id|nome>
agentop session kill   <id|nome>
agentop session rename <id|nome> "rótulo"
agentop session note   <id|nome> "texto"

• ls mostra só o que está rodando, agrupado por projeto. --all inclui as sessões encerradas, perdidas e fechadas. --group aceita project, tree, repo, task, harness, model, status, marked e none.
• Sem --bg, a sessão assume o seu terminal; a tecla para sair dela é mostrada antes.
• --effort vale para claude (low, medium, high, xhigh, max) e antigravity (low, medium, high).

Várias sessões de uma vez, todas na mesma tarefa:

agentop session batch --task "landing page" \
  --session "claude: escreva o hero" \
  --session "codex: escreva os testes"
agentop session open "landing page"   # reabre a tarefa inteira depois

Tarefas (Agentask)

agentop task                    # lista as tarefas com custo somado
agentop task show <id|nome>     # uma tarefa, com as tentativas lado a lado
agentop task deliver <ref>      # marca como entregue e anexa a evidência do git
agentop task abandon <ref>      # marca como abandonada

Todas aceitam --json.

Claude Code em paralelo

agentop hooks install     # instala uma skill e um hook SessionStart no Claude Code
agentop hooks status
agentop hooks uninstall   # remove exatamente o que o install escreveu

A skill ensina o Claude Code a propor a divisão de um trabalho em várias sessões com agentop session batch; o hook conta a ele quais sessões já estão rodando. Nada é escrito em ~/.claude antes de você rodar o install, e o Claude sempre pede o seu sim antes de iniciar sessões.

Avisos de sessão

agentop events watch --desktop   # notifica quando uma sessão espera, pede permissão ou termina
agentop events status

Backup

agentop backup             # métricas e um manifesto que reconstrói os repositórios
agentop backup --plan      # mostra o que seria gravado, sem gravar
agentop backup schedule daily
agentop restore <arquivo>

Credenciais nunca entram no backup.

Atualização e início automático

agentop upgrade                     # atualiza para a última versão
agentop check-update                # avisa só quando há versão nova
agentop autostart server enable     # sobe o servidor junto com o sistema
agentop autostart status
agentop autostart server disable