Skip to content
ver .md sin procesar

CLI de Dailybot para Plan

Usa Dailybot Plan (Beta) desde la línea de comandos: credenciales, nombrar al agente, un briefing de una tarea para un agente, el índice de comandos y los códigos de salida.

Beta

Plan está en beta. Todo lo que está bajo /plan en la aplicación web, los comandos del CLI y de la agent skill para proyectos, objetivos, tableros y tareas, y la API pública /v1/plan/ puede cambiar antes de la disponibilidad general. ¿Quieres probarlo con tu equipo? Escribe a [email protected].

El CLI de Dailybot cubre Plan bajo dailybot plan, con los grupos de subcomandos tasks, task, board, project y goal (164 comandos). Llama a la misma API pública que cualquier integración. Todo lo que hay en esta página requiere dailybot-cli 4.0.0 o posterior: en 4.0.0 dailybot plan pasó a ser el único punto de entrada y llegaron los comandos de notificaciones, rutas, reportes programados, resumen diario, búsqueda de canales y línea de tiempo. 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, 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

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.

Brecha conocida: la delegación de tareas aún 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).

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