Primeiros passos

1. Abra o agentop

agentop

O agentop sem argumentos abre o cockpit: um app em tela cheia no terminal, que não suja o seu histórico de rolagem. Troque de aba com ← / →, de painel com tab, e o rodapé sempre mostra as teclas que funcionam onde o foco está.

2. Suba o servidor local

Na aba Serviços, selecione agentistics e inicie. Ou, direto pelo terminal:

agentop server          # em primeiro plano
agentop server --bg     # em segundo plano, com logs em ~/.agentistics

O servidor ocupa duas portas:

Porta	O que serve
`47292`	a interface web (é esta que você abre)
`47291`	a API e o MCP

Se a porta estiver ocupada, agentop server --port 4000 coloca a API na 4000 e a web na 4001.

3. Abra a interface web

Abra http://localhost:47292 no navegador.

Na primeira vez, o agentistics pergunta o que fazer com o histórico. O Claude Code apaga as transcrições mais antigas que cleanupPeriodDays (30 dias por padrão) toda vez que inicia:

Modo	O que guarda
`consolidate` (recomendado)	um JSON pequeno de métricas por sessão; sobrevive à limpeza sem duplicar o chat
`full`	também espelha as transcrições, com o chat; cresce sem limite
`off`	nada além do que já está em `~/.claude`

4. Comece uma sessão

Pelo terminal, uma sessão em segundo plano já vinculada a uma tarefa:

agentop session claude -p "revise o README" --bg --task "docs"
agentop session ls

Os harnesses que o agentop session sabe iniciar são claude, codex, gemini, antigravity, kimi e copilot. Para entrar na sessão e para encerrá-la:

agentop session attach <id|nome>
agentop session kill <id|nome>

Você também pode iniciar uma sessão pela aba Sessões do cockpit (tecla a) ou pela tela de sessões da interface web.

5. Veja a tarefa no Agentask

Abra Agentask no menu da interface web. A tarefa docs aparece com as sessões vinculadas a ela e o custo somado. Pelo terminal:

agentop task

6. Deixe ligado com o sistema (opcional)

agentop autostart server enable
agentop autostart status

No Linux e no WSL isso cria um serviço de usuário do systemd; no macOS, um agente do launchd.

Próximos passos

CLI — agentop: todos os comandos do dia a dia.
A interface: frota de sessões, custos e Agentask.
MCP: os dados do agentistics dentro dos seus agentes.