CLI de Dailybot para Plan

El CLI de Dailybot cubre Plan bajo dailybot plan, con los grupos de subcomandos tasks, task, board, project, goal, label y views. Llama a la misma API pública que la app web /plan y el agent skill — Plan es agent-first, así que las hojas de abajo coinciden con las cadenas OpenAPI x-cli-command. Todo lo que hay en esta página requiere un dailybot-cli actual en la superficie plan (4.0.0 o posterior para el rename; las hojas agent-first T5 llegan en la línea CLI plan__next). Actualiza con dailybot upgrade.

Credenciales

• dailybot login te inicia sesión con un código de un solo uso por correo. El token de login solo viaja al host de API que lo emitió.
• DAILYBOT_API_KEY usa una API key. Una key personal actúa como su persona; una key de agente o de la organización nunca. Lo que puede hacer cada credencial está en Autenticación para Plan.
• Perfiles por repositorio guardan las keys de un repositorio en .dailybot/env.json, que debe seguir en gitignore: dailybot env add, dailybot env use, dailybot env off (y on, show, list, remove). El perfil activo sustituye a DAILYBOT_API_KEY y a la sesión de login en ese repositorio.

Nombra al agente

Pasa el flag raíz --agent-name, o define DAILYBOT_AGENT_NAME (gana el flag). Sin ninguno, una persona actúa directamente y no se sella nada. Es una etiqueta de atribución, nunca una credencial, así que no cambia ningún permiso.

dailybot --agent-name "Claude Code" plan task comment ENG-12 "Reproducido y corregido"

El CLI envía agent_name en escrituras JSON y X-Dailybot-Agent-Name en cargas y escrituras sin cuerpo, nunca en lecturas. Los nombres siguen las reglas de atribución: caracteres simples, hasta 128, nunca se truncan. Un nombre más largo se rechaza localmente con invalid_agent_attribution; una key de agente que envía uno recibe el mismo error del servidor.

task comments muestra entonces Jane Doe via "Claude Code", y task get agrega una línea Agents con los ejecutores, del más reciente al más antiguo.

Briefing de una tarea para un agente

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

dailybot plan task brief <task> [--download DIR] [--force] [--json] lee la tarjeta completa, adjuntos incluidos. Con --download DIR guarda los adjuntos allí como <uuid8>-<name>, y nunca sobrescribe un archivo salvo que pases --force. --json imprime el resultado para un programa. La tarea es una clave (ENG-142) o un uuid.

Índice de comandos

Nombres de subcomandos por grupo. Ejecuta dailybot plan <grupo> <comando> --help para ver flags y ejemplos; es la referencia autorizada para la versión que tienes instalada, y las versiones nuevas agregan comandos. El índice de abajo coincide con 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

Hojas agent-first (coinciden con OpenAPI x-cli-command; prefiere estos nombres en skills y docs):

CLI	Puerta de la 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= (solo lectura; project obligatorio)
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 la misma ruta; If-Match obligatorio
dailybot plan tasks board	GET /v1/plan/tasks/board/ (instantánea agrupada / swimlane)
dailybot plan task brief	GET …/tasks/{id}/brief/ (lectura principal de la tarjeta para el agente)
dailybot plan board member update	PATCH …/members/{user}/ (cuerpo vacío = inspección; rol solo lectura)
dailybot plan project member update	PATCH …/members/{user}/ (solo inspección)
dailybot plan label list|create|update|delete	/v1/plan/labels/ (taxonomía de la org)

Salida: las hojas de Plan aceptan --json para máquinas. No hay --yaml. Aún no hay --wait / --follow — los agentes hacen poll con dailybot plan tasks changes (o el feed delta del tablero).

task delete es un archivado suave (igual que task archive). El CRUD de estructura necesita una credencial de persona.

Nuevo en 4.0.0 bajo dailybot plan tasks: notifications catalog|get|set (tus propios interruptores), routes … (rutas de canal de la organización), reports … (reportes programados diarios y semanales), briefing … (tu resumen diario), channels search (dónde pueden publicar rutas y reportes) y timeline (tareas, hitos y proyectos en una ventana de fechas, con filtros por proyecto e hito). Consulta la referencia de Plan · Notificaciones y reportes para ver los endpoints detrás de ellos.

Phase 2 a propósito: la delegación de tareas no está disponible (la API responde 501 hasta que salga su runtime de agentes). Responde en un hilo con dailybot plan task comment --reply-to <uuid-del-comentario> (el campo de la API es parent_comment). No selles author_kind=agent desde una key de agente de org — usa --agent-name con una credencial de persona y lee executed_by_agent.

Códigos de salida

Código	Significado
0	Éxito
1	Éxito parcial u otro error
2	Entrada inválida, incluidos invalid_identifier e invalid_agent_attribution
3	Problema de credencial o de persona (actor_required, errores de credencial)
4	Rechazado (insufficient_scope, guest_not_allowed)
5	No encontrado, o no visible para ti
6	Error transitorio: reintenta
7	Rechazado
8	Error de transporte
9	El cursor delta expiró: vuelve a leer el snapshot del tablero

Ver también

• Agentes en Plan
• Errores de Plan
• Autenticación del CLI