A interface: frota de sessões, custos, Agentask
A interface web abre em http://localhost:47292 depois de agentop server. Ela é responsiva,
funciona no celular e pode ser instalada como PWA. Português e inglês, tema claro e escuro.
Frota de sessões
Seção intitulada “Frota de sessões”A tela de sessões (/sessions) mostra a frota: as sessões rodando agora e as conversas que dá
para reabrir, de todos os harnesses.
- À esquerda, a lista de sessões. Agrupe por projeto, repositório, tarefa, harness, modelo ou status, e guarde sessões em grupos com nome.
- No centro, a visão geral da frota ou a sessão aberta, com o chat e o terminal ao vivo.
- Diálogos de permissão: quando uma sessão para numa pergunta, o cartão mostra a pergunta e as opções lidas da própria tela, e você escolhe uma. Não existe um botão “aprovar” às cegas.
- Duas sessões lado a lado em telas grandes (no celular, uma por vez).
Cada sessão tem um estado:
| Estado | Significado |
|---|---|
working |
a tela mudou desde a última leitura |
waiting |
viva e parada, esperando você |
NEEDS APPROVAL |
uma pergunta que bloqueia está na tela |
exited |
o comando terminou; a última tela continua legível |
lost |
conhecida, mas não está mais rodando (um reboot, por exemplo); pode ser reaberta |
external |
um assistente rodando na máquina que o agentop não iniciou |
Separar uma pergunta que bloqueia de uma pausa comum só funciona para Claude Code, Codex e Kimi. Nos
outros harnesses, a pergunta aparece como waiting.
Uma sessão reaberta volta com o nome, a nota e a tarefa.
A tela Custos mostra o gasto por modelo e por data, orçamento e previsão, e a eficiência do cache. Custo e uso também aparecem por sessão, projeto, repositório e harness.
- É uma estimativa no preço da API. Quem paga uma assinatura fixa pode cadastrar o plano em Ajustes → Cobrança e ver o mesmo gasto comparado com o que paga de verdade.
- De onde vêm os preços. Três camadas: uma tabela embutida (a base, que sempre funciona), um
conjunto de dados da comunidade e as páginas dos próprios fornecedores. Um preço que não bate
com as outras fontes é descartado. Ajustes → Preços lista cada modelo que esta máquina já
usou, com a origem do preço (
official,communityoubuiltin). - Tokens são sempre os quatro contadores: entrada, saída, leitura de cache e escrita de cache.
- Dólar ou real. A conversão para real usa a cotação atual.
Agentask
Seção intitulada “Agentask”O Agentask (/tasks, em beta) é o board de tarefas. Uma tarefa é medida pelas sessões que
trabalharam nela: custo, rodadas, tokens e harnesses saem dessas sessões.
- Veja em tabela ou em kanban; arrastar entre colunas muda o status.
- Vincule sessões direto na tarefa ou em subtarefas.
- Os status podem ser editados (novos, renomeados, com cor).
blockedexige um motivo ou uma tarefa que bloqueia;doneexige pelo menos uma sessão vinculada.- Uma tarefa que ninguém conseguiu precificar vai para o fim da ordenação por custo, em vez de aparecer como zero.
Pelo terminal, use agentop task e agentop session batch --task. Pelos agentes, use as
ferramentas agentistics_task_* do MCP.
As outras telas
Seção intitulada “As outras telas”| Tela | Para que serve |
|---|---|
| Home | indicadores, atividade no tempo, mapa de calor, uso por hora, destaques |
| Top de uso | o que mais consumiu |
| Repositórios | agrupado pelo remote do git, então o mesmo repositório se junta mesmo em pastas diferentes |
| Tags | agrupamentos salvos, como “quanto o cliente X custou neste mês” |
| Ferramentas | ranking de chamadas de ferramentas e tokens por ferramenta |
| Comparar | os harnesses lado a lado |
| Personalizado | monte o seu próprio layout arrastando componentes |
| Exportar | relatório em PDF com as seções, o período e o tema que você escolher |
| Ajustes | preferências, notificações, dados e fontes, backup, harnesses, preços, cobrança |
Quando um harness não produz uma métrica, ela aparece como N/A, nunca como 0.