Saltar al contenido principal

​
Descripción General

Los comandos de workflow convierten al Apollo CLI en un gestor de trabajo pensado para desarrolladores. Inicia una tarea y obtiene una rama git automáticamente. Deja que la puntuación de urgencia te diga en que trabajar a continuación. Guarda tus filtros favoritos. Establece un proyecto predeterminado para dejar de escribir -p en todas partes.
Todos los comandos de workflow soportan --json para scripting e integración con Claude Code.

​
Iniciar / Detener / Actual

​
apollo task start <id>

Resuelve una tarea, crea una rama git, la marca como in_progress y rastrea tu sesión activa. 
# Start by name (fuzzy match)
apollo task start "fix auth bug"

# Start by short ID
apollo task start a1b2c3d4

# Custom branch name
apollo task start "fix auth" --branch "hotfix/auth-fix"

# Skip branch creation
apollo task start "review docs" --no-branch
​
--base
string
predeterminado:"main"
Rama base desde la cual crear
​
--branch
string
Sobreescribir el nombre de rama generado automáticamente
​
--no-branch
boolean
predeterminado:"false"
Omitir la creación de rama git, solo actualizar el estado de la tarea
Que sucede:
  1. Genera el nombre de rama: feat/<shortId>-<slugified-title>
  2. Crea y cambia a la rama (o cambia si ya existe)
  3. Almacena los metadatos de la tarea como configuración de rama git
  4. Marca la tarea como in_progress en Apollo
  5. Te asigna la tarea automáticamente si no está asignada
  6. Almacena la sesión activa localmente para stop y current

​
apollo task stop [id]

Detiene tu sesión activa. Guarda cambios no comprometidos en stash, actualiza el estado y muestra el tiempo transcurrido. 
# Stop the current active task
apollo task stop

# Stop and mark as done
apollo task stop --done

# Stop without git stash
apollo task stop --no-stash
​
--done
boolean
predeterminado:"false"
Marcar la tarea como done en lugar de volver a todo
​
--no-stash
boolean
predeterminado:"false"
Omitir git stash aunque haya cambios no comprometidos

​
apollo task current

Muestra la tarea activa actualmente con el tiempo transcurrido. 
apollo task current
# Working on: Fix authentication bug
#   Project: Apollo
#   Branch:  feat/a1b2c3d4-fix-authentication-bug
#   Elapsed: 1h 23m
#   ID:      a1b2c3d4-...

​
Siguiente Tarea (Ranking Inteligente)

​
apollo task next

Muestra tus tareas de mayor prioridad ordenadas por una puntuación de urgencia ponderada. Inspirado en el sistema de coeficientes de urgencia de Taskwarrior. 
# Show top 5 tasks (default)
apollo task next

# Show top 3 with score breakdown
apollo task next -n 3 --explain

# Scope to a project
apollo task next -p "Apollo"
​
-p, --project
string
Limitar a un proyecto específico
​
-n, --count
number
predeterminado:"5"
Número de tareas a mostrar
​
--explain
boolean
predeterminado:"false"
Mostrar el desglose de puntuación de cada tarea

​
Algoritmo de Puntuación

Cada tarea se puntua en 6 factores con diferentes pesos:
FactorPesoMax BrutoDescripción
Priority4x20critical=20, high=15, medium=10, low=5
Due Date3x20overdue=20, today=18, this week=12, this month=6
Unblocked2x10+10 si no hay bloqueos, -20 si bloqueado
Impact2x20+5 por tarea que desbloqueas (max 4)
Age1x50-5 basado en días desde la creación
Status1x8in_progress=8, todo=5, blocked=0
La puntuación bruta se normaliza a 0-100. Usa --explain para ver el desglose exacto.

​
Filtros Guardados

Guarda combinaciones de filtros de tareas usados frecuentemente y reprodúcelos con un solo comando.

​
apollo filter save <name>

# Save a filter for high-priority blocked tasks
apollo filter save "my-blockers" --status "blocked" --priority "high,critical" --assignee me

# Save a filter for a project's todo list
apollo filter save "apollo-todo" --project "Apollo" --status "todo"
​
-s, --status
string
Filtro de estado (separado por comas)
​
--priority
string
Filtro de prioridad (separado por comas)
​
-a, --assignee
string
Nombre del responsable o me
​
-p, --project
string
Nombre del proyecto
​
--release
string
Nombre de la release
​
--unassigned
boolean
Solo tareas no asignadas
​
--due-before
string
Con fecha límite antes de
​
--limit
string
Máximo de resultados

​
apollo filter list

apollo filter list
# Name          Flags
# my-blockers   status=blocked, priority=high,critical, assignee=me
# apollo-todo   project=Apollo, status=todo

​
apollo filter run <name>

Reproduce el filtro guardado ejecutando apollo task list con las flags almacenadas. 
apollo filter run "my-blockers"
# Equivalent to: apollo task list --status blocked --priority high,critical --assignee me

​
apollo filter delete <name>

apollo filter delete "my-blockers"
Los filtros se almacenan localmente en ~/.apollo/apollo-local.json y persisten entre sesiones.

​
Contexto de Proyecto

Establece un proyecto predeterminado para no tener que escribir -p "NombreDelProyecto" en cada comando.

​
apollo context set <project>

apollo context set "Apollo"
# Default project set to: Apollo
# All commands will use this project unless -p is specified.

​
apollo context show

apollo context show
# Default project: Apollo

​
apollo context clear

apollo context clear
# Default project cleared.
Comandos que respetan el contexto: task list, release list, epic list, kb list, kb search, kb folders. Una flag -p explícita siempre sobreescribe el contexto predeterminado.

​
Dependencias de Tareas

​
apollo task deps [id]

Visualiza el árbol de dependencias de una tarea — quién te bloquea y a quién desbloqueas. 
# Show deps for a specific task
apollo task deps "fix auth bug"

# Only show upstream blockers
apollo task deps "fix auth" --direction up

# Deeper traversal
apollo task deps "fix auth" --depth 5

# Project-wide dependency chains
apollo task deps --project "Apollo"
​
--direction
string
predeterminado:"both"
up (solo bloqueadores), down (solo dependientes), o both
​
--depth
number
predeterminado:"3"
Profundidad maxima de recorrido
​
-p, --project
string
Mostrar todas las cadenas de dependencias en un proyecto (sin necesidad de ID de tarea)
Vista de tarea individual muestra un árbol con iconos de estado: 
  Dependencies for: Fix auth bug
  ──────────────────────────────────────────────────

  ▲ Blocks me (upstream):
  │
  └── ✓ Set up OAuth provider done
      └── ○ Configure redirect URLs todo

  ▼ I unblock (downstream):
  │
  ├── ○ Update login page todo
  └── ○ Add SSO support todo
Vista del proyecto muestra cadenas lineales: 
  Dependency chains in Apollo (8 tasks with deps)
  ──────────────────────────────────────────────────

  Chain 1 (3 tasks):
  ✓ Set up OAuth → ● Fix auth bug → ○ Update login page

  Chain 2 (2 tasks):
  ○ Design API schema → ○ Implement REST endpoints