Pular para o conteúdo

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.

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, community ou builtin).
  • 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.

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).
  • blocked exige um motivo ou uma tarefa que bloqueia; done exige 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.

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.