Instalar

Linux, WSL e macOS

Uma linha:

curl -fsSL https://agentistics.com.br/cli | bash

O script:

baixa o binário agentop certo para a sua máquina, da última release do GitHub (Linux x86_64 com glibc ou musl, macOS x86_64 ou arm64);
instala em ~/.local/bin (ou em /usr/local/bin quando roda como root);
instala o tmux se ele faltar, porque o gerenciador de sessões depende dele;
avisa se a pasta de instalação não estiver no seu PATH.

Se aparecer o aviso de PATH, adicione a pasta:

echo 'export PATH="${HOME}/.local/bin:${PATH}"' >> ~/.bashrc && source ~/.bashrc

Via npm (Linux x86_64)

npm i -g @agentistics/agentop

É o mesmo binário, baixado da mesma release no postinstall. Em qualquer outra plataforma a instalação por npm falha com uma mensagem clara. Precisa de Node 18 ou mais novo.

Windows

Baixe o .msi ou o .exe mais recente na página de releases. Na primeira execução o agentistics detecta sozinho onde estão os dados do Claude Code (Windows nativo ou WSL).

Se o SmartScreen avisar, clique em “Mais informações” e depois em “Executar assim mesmo”: o binário ainda não é assinado.

O gerenciador de sessões (agentop session, a aba de sessões) precisa de tmux. No Windows, rode o agentop dentro do WSL para usar essa parte.

Conferir

agentop --version
agentop --help

Atualizar

agentop upgrade

O upgrade baixa a última versão, confere o download antes de trocar o binário, guarda o anterior como .bak e reinicia os serviços que estavam rodando. Para só saber se há versão nova:

agentop check-update

Ele fica em silêncio quando você já está na última versão.

Próximo passo

Primeiros passos