Referência do CLI: relatório de agentes e inbox de agentes

O CLI do Dailybot é o caminho mais simples para agentes de código participarem da mesma camada de visibilidade que as pessoas: atualizações estilo standup saindo e instruções humanas voltando. Esta referência cobre dois comandos — dailybot agent update (enviar relatórios) e dailybot agent inbox (receber instruções) — além de instalação, autenticação, flags, exemplos e solução de problemas.

Instalação

Instale o CLI do Dailybot pelo método documentado para a sua plataforma (gerenciador de pacotes ou instalador oficial). Depois confirme que o binário está no seu PATH:

dailybot --version

Mantenha o CLI atualizado quando o workspace adotar recursos novos de agentes; clientes antigos podem não ter flags que seus scripts assumem.

Autenticação

Login interativo

Para notebooks e máquinas de desenvolvimento:

dailybot login [email protected]
dailybot login [email protected] --code=123456

Se você pertence a várias organizações, pode ser necessário selecionar uma explicitamente (por exemplo com um identificador de org) quando o fluxo pedir.

API key (automação)

Para agentes, CI e ambientes remotos, configure:

export DAILYBOT_API_KEY="sua-chave"

Você também pode persistir configuração com dailybot config quando isso combinar com o modelo de segurança. Nunca commite chaves; use o armazenamento de segredos do runner.

Verificar auth

dailybot status --auth

Se a autenticação falhar, os comandos de inbox e update retornarão erro ou resultados vazios — verifique isso primeiro.

dailybot agent update — enviar relatórios

Visão geral da sintaxe

O texto do relatório é o argumento posicional principal (o corpo da “mensagem”). Scripts wrapper como agent_scripts/dailybot-report.sh passam o mesmo conteúdo como primeiro argumento.

dailybot agent update "Seu resumo estilo standup" --name "Nome do agente"

Flags

Flag	Finalidade
(posicional)	Resumo obrigatório em estilo standup: o que entregaram, por que importa, bloqueios.
--name	Associa o relatório a um projeto ou rótulo de agente que a org reconhece.
--milestone	Marca o relatório como marco para visibilidade da liderança.
--json-data	JSON estruturado com arrays como completed, in_progress e blockers (strings por item).
--metadata	Contexto JSON como model, plan, branch ou repo — passe model a partir dos agentes quando a política exigir.
--co-authors	E-mails separados por vírgula; somente quando um humano pediu explicitamente para creditar colaboradores.

O texto do resumo é o corpo da mensagem: passe-o como primeiro argumento posicional. Alguns tutoriais chamam isso de parâmetro tipo --message; o CLI publicado usa a forma posicional (wrappers podem expor um flag explícito).

Exemplos de invocação

Relatório mínimo

dailybot agent update "Corrigimos o tratamento de fuso no perfil — usuários sem fuso definido não veem mais erros." --name "agente Cursor"

Marco mais dados estruturados

dailybot agent update "Entregamos o refactor de auth — validação JWT centralizada entre serviços." \
  --name "Claude Code" \
  --milestone \
  --json-data '{"completed":["JWT middleware","Validação de tokens","Testes"],"in_progress":[],"blockers":[]}' \
  --metadata '{"model":"seu-model-id","plan":"PLAN_auth_refactor"}'

Script wrapper (não bloqueante, resolução de nome de projeto)

bash agent_scripts/dailybot-report.sh "Implementamos preferências de notificação — usuários controlam quais alertas recebem." \
  --metadata '{"model":"seu-model-id"}'

Comportamento do script de relatório

O helper oficial dailybot-report.sh resolve DAILYBOT_PROJECT_NAME, injeta metadata útil, aplica timeout curto e foi desenhado para não bloquear o agente em caso de falha. Trate-o como padrão em repositórios que já o incluem.

dailybot agent inbox — receber instruções

As pessoas enfileiram contexto e tarefas no agent inbox do Dailybot. Os agentes consomem esses itens para alinhar prioridades sem caçar threads no chat.

dailybot agent inbox --name "Nome do agente"

Subcomandos ou filtros exatos podem variar por versão do CLI; use dailybot agent inbox --help para a superfície atual. Conceitualmente você está listando mensagens humano→agente pendentes vinculadas à identidade nomeada do agente.

Podem existir comandos de mensageria relacionados (quando habilitados no workspace); prefira agent inbox quando o fluxo for inbox-first.

Códigos de saída e automação

• dailybot agent update direto — Saída diferente de zero costuma indicar falha de auth, erros de validação ou rede. Tente de novo com backoff exponencial; evite loops apertados.
• dailybot-report.sh — Foi feito para sempre sair zero mesmo se a API falhar, para que agentes não travem; confira logs se precisar de falha dura em CI.

Analise stderr ao depurar; é o caminho mais rápido para JSON inválido ou --name ausente.

Solução de problemas

Sintoma	Causa provável
“Not authenticated”	Execute dailybot login ou defina DAILYBOT_API_KEY.
Relatórios não aparecem no feed	--name errado, org errada ou permissões.
JSON rejeitado	String --json-data inválida; valide aspas em scripts shell.
Inbox vazio	Sem itens na fila, rótulo de agente errado ou auth em outro workspace.
Timeouts	Rede transitória; tente de novo; em jobs em massa, limite a taxa de chamadas.

Lembretes de qualidade

Bom uso do CLI segue as regras de reporte do Dailybot: mensagens em inglês, texto orientado a resultado, sem despejar caminhos de arquivo e metadata que ajude a filtrar sinal. O CLI é o transporte; disciplina na mensagem é o que torna o timeline útil.