CLI do Dailybot para o Plan

A CLI do Dailybot cobre o Plan em dailybot plan, com os grupos de subcomandos tasks, task, board, project, goal, label e views. Ela chama a mesma API pública do app web /plan e do agent skill — o Plan é agent-first, então as folhas abaixo coincidem com as strings OpenAPI x-cli-command. Tudo nesta página exige um dailybot-cli atual na superfície plan (4.0.0 ou posterior para o rename; as folhas agent-first T5 chegam na linha CLI plan__next). 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, board, 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|update}, members, mentionables, move-preview, reorder, restore, snapshot, star, state {archive|create|reorder|restore|update}, states, tasks, unstar, update, view {create|save}, views, visit
dailybot plan project: archive, attach, attachment {delete|get}, attachments, create, get, list, member {add|remove|update}, members, milestone-attach, milestone-attachment {delete|get|rename}, milestone-attachments, milestone-complete, milestone-create, milestone-delete, milestone-reopen, milestone-restore, milestone-update, milestones, reorder, 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 {create|save}, views
dailybot plan goal: archive, attach, attachment {delete|get}, attachments, create, get, link, list, restore, unlink, update
dailybot plan label: list, create, update, delete
dailybot plan views: workspace, workspace save

Folhas agent-first (coincidem com OpenAPI x-cli-command; prefira estes nomes em skills e docs):

CLI	Porta da API
dailybot plan project reorder	POST …/projects/{id}/reorder/ (before | after)
dailybot plan board reorder	POST …/boards/{id}/reorder/ (before | after | project)
dailybot plan board move-preview	GET …/move-preview/?project= (somente leitura; project obrigatório)
dailybot plan board view create	POST …/boards/{id}/views/ + Idempotency-Key
dailybot plan project view create	POST …/projects/{id}/views/ + Idempotency-Key
dailybot plan views workspace	GET /v1/plan/views/workspace/
dailybot plan views workspace save	PUT o mesmo caminho; If-Match obrigatório
dailybot plan tasks board	GET /v1/plan/tasks/board/ (snapshot agrupado / swimlane)
dailybot plan task brief	GET …/tasks/{id}/brief/ (leitura principal do card para o agente)
dailybot plan board member update	PATCH …/members/{user}/ (corpo vazio = inspeção; papel só leitura)
dailybot plan project member update	PATCH …/members/{user}/ (só inspeção)
dailybot plan label list|create|update|delete	/v1/plan/labels/ (taxonomia da org)

Saída: as folhas do Plan aceitam --json para máquinas. Não há --yaml. Ainda não há --wait / --follow — agentes fazem poll com dailybot plan tasks changes (ou o feed delta do quadro).

task delete é um arquivamento suave (igual a task archive). O CRUD de estrutura precisa de credencial de pessoa.

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.

Phase 2 de propósito: a delegação de tarefas 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). Não sele author_kind=agent a partir de uma key de agente de org — use --agent-name com credencial de pessoa e leia executed_by_agent.

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

• Agentes no Plan
• Erros do Plan
• Autenticação da CLI