Skip to content
ver .md original

CLI do Dailybot para o Plan

Use o Dailybot Plan (Beta) pela linha de comando: credenciais, nomear o agente, um briefing de uma tarefa para um agente, o índice de comandos e os códigos de saída.

Beta

Plan está em beta. Tudo o que está em /plan no aplicativo web, os comandos da CLI e da agent skill para projetos, metas, quadros e tarefas, e a API pública /v1/plan/ podem mudar antes da disponibilidade geral. Quer testar com sua equipe? Escreva para [email protected].

A CLI do Dailybot cobre o Plan em dailybot plan, com os grupos de subcomandos tasks, task, board, project e goal (164 comandos). Ela chama a mesma API pública de qualquer integração. Tudo nesta página exige dailybot-cli 4.0.0 ou posterior: na 4.0.0 dailybot plan passou a ser o único ponto de entrada e chegaram os comandos de notificações, rotas, relatórios agendados, resumo diário, busca de canais e linha do tempo. Atualize com dailybot upgrade.

Credenciais

  • dailybot login faz seu login com um código de uso único por e-mail. O token de login só viaja para o host de API que o emitiu.
  • DAILYBOT_API_KEY usa uma API key. Uma key pessoal age como sua pessoa; uma key de agente ou da organização nunca. O que cada credencial pode fazer está em Autenticação para o Plan.
  • Perfis por repositório guardam as keys de um repositório em .dailybot/env.json, que deve continuar no gitignore: dailybot env add, dailybot env use, dailybot env off (e on, show, list, remove). O perfil ativo substitui DAILYBOT_API_KEY e a sessão de login nesse repositório.

Nomeie o agente

Passe a flag raiz --agent-name, ou defina DAILYBOT_AGENT_NAME (a flag vence). Sem nenhum dos dois, uma pessoa está agindo diretamente e nada é selado. É um rótulo de atribuição, nunca uma credencial, então não altera nenhuma permissão.

dailybot --agent-name "Claude Code" plan task comment ENG-12 "Reproduzido e corrigido"

A CLI envia agent_name em escritas JSON e X-Dailybot-Agent-Name em uploads e escritas sem corpo, nunca em leituras. Os nomes seguem as regras de atribuição: caracteres simples, até 128, nunca truncados. Um nome maior é recusado localmente com invalid_agent_attribution; uma key de agente que enviar um recebe o mesmo erro do servidor.

task comments passa a mostrar Jane Doe via "Claude Code", e task get acrescenta uma linha Agents com os executores, do mais recente ao mais antigo.

Briefing de uma tarefa para um agente

dailybot plan task brief ENG-142 --download ./brief

dailybot plan task brief <task> [--download DIR] [--force] [--json] lê o cartão inteiro, anexos incluídos. Com --download DIR salva os anexos ali como <uuid8>-<name>, e nunca sobrescreve um arquivo a menos que você passe --force. --json imprime o resultado para um programa. A tarefa é uma chave (ENG-142) ou um uuid.

Índice de comandos

Nomes de subcomandos por grupo. Rode dailybot plan <grupo> <comando> --help para ver flags e exemplos; é a referência oficial para a versão instalada, e as versões novas acrescentam comandos. O índice abaixo corresponde ao dailybot-cli 4.0.0.

dailybot plan tasks: activity, attachments-resolve, briefing {get|preview|send-test|set}, changes, channels {search}, counts, cursor, entitlements, favorites, inbox, inbox-read, inbox-read-all, inbox-unread, mine, notifications {catalog|get|set}, recents, reports {create|delete|get|list|preview|runs|send-test|update}, routes {create|delete|deliveries|get|list|send-test|update}, search, status, timeline, view {delete|get|star|unstar|update}
dailybot plan task: activity, archive, attach, attachment {delete|get}, attachments, brief, bulk, children, comment, comment-attach, comment-attachment {delete|get}, comment-attachments, comment-delete, comment-edit, comment-react, comment-reactions, comment-unreact, comments, create, delete, duplicate, events, get, labels, link, list, move, mute, participants {add|list|remove}, relations, restore, set-owner, unlink, unmute, unwatch, update, watch
dailybot plan board: archive, create, get, label {create|delete|update}, labels, list, member {add|remove}, members, mentionables, restore, snapshot, star, state {archive|create|reorder|restore|update}, states, tasks, unstar, update, view {save}, views, visit
dailybot plan project: archive, attach, attachment {delete|get}, attachments, create, get, list, member {add|remove}, members, milestone-attach, milestone-attachment {delete|get|rename}, milestone-attachments, milestone-complete, milestone-create, milestone-delete, milestone-reopen, milestone-restore, milestone-update, milestones, restore, update, update-attach, update-attachment {delete|get|rename}, update-attachments, update-delete, update-edit, update-get, update-post, update-react, update-reactions, update-unreact, updates, view {save}, views
dailybot plan goal: archive, attach, attachment {delete|get}, attachments, create, get, link, list, restore, unlink, update

Novo na 4.0.0 em dailybot plan tasks: notifications catalog|get|set (as suas chaves), routes … (rotas de canal da organização), reports … (relatórios agendados diários e semanais), briefing … (o seu resumo diário), channels search (onde rotas e relatórios podem publicar) e timeline (tarefas, marcos e projetos em uma janela de datas, com filtros por projeto e marco). Veja a referência de Plan · Notificações e relatórios para os endpoints por trás deles.

Lacuna conhecida: a delegação de tarefas ainda não está disponível (a API responde 501 até o runtime de agentes ser lançado). Responda em uma thread com dailybot plan task comment --reply-to <uuid-do-comentário> (o campo da API é parent_comment).

Códigos de saída

Código Significado
0 Sucesso
1 Sucesso parcial ou outro erro
2 Entrada inválida, incluindo invalid_identifier e invalid_agent_attribution
3 Problema de credencial ou de pessoa (actor_required, erros de credencial)
4 Recusado (insufficient_scope, guest_not_allowed)
5 Não encontrado, ou não visível para você
6 Erro transitório: tente de novo
7 Recusado
8 Erro de transporte
9 O cursor delta expirou: leia o snapshot do quadro de novo

Veja também