Saltar al contenido principal

Descripción General

Los comandos de tareas te permiten gestionar tus tareas de Apollo sin abrir la aplicación web. Todos los comandos soportan resolución fuzzy de nombres — puedes referenciar tareas por título, coincidencia parcial o UUID.

Comandos

Listar Tareas

# Your assigned tasks (shortcut)
apollo task mine

# All tasks in a project
apollo task list -p "Apollo"

# Filter by status
apollo task list -s todo,in_progress

# Combine filters
apollo task list -p "Apollo" -s in_progress -a me --limit 50

# Filter by release, specialty, or task type
apollo task list -p "Delfin One" --release "P3.1"
apollo task list -p "Delfin One" --specialty "frontend"
apollo task list -p "Delfin One" --unassigned --due-before 2026-03-01
Opciones:
FlagDescripción
-p, --project <name>Filtrar por nombre o ID de proyecto
-s, --status <status>Filtrar por estado: backlog, todo, in_progress, blocked, done
-a, --assignee <name>Filtrar por responsable (usa me para ti mismo)
--release <name>Filtrar por nombre de release (coincidencia fuzzy)
--specialty <name>Filtrar por especialidad (ej: frontend, back-end, ai)
--task-type <name>Filtrar por tipo de tarea (ej: feature, bug, chore)
--unassignedMostrar solo tareas sin responsable
--due-before <date>Tareas con fecha límite en o antes de una fecha (YYYY-MM-DD)
--limit <n>Máximo de resultados (por defecto: 50)

Ver Detalles de la Tarea

# By title (fuzzy match)
apollo task view "fix auth"

# By UUID
apollo task view 550e8400-e29b-41d4-a716-446655440000
Muestra todos los detalles de la tarea: estado, prioridad, responsable, proyecto, descripción, fechas y dependencias.

Crear una Tarea

# Basic
apollo task create -t "Add dark mode to CLI" -p "Apollo"

# Full options
apollo task create \
  -t "Implement token refresh" \
  -p "Delfin One" \
  --priority high \
  --assignee me \
  --description "Handle expired JWT tokens gracefully" \
  --due 2026-03-15
Opciones:
FlagDescripción
-t, --title <title>Título de la tarea (obligatorio)
-p, --project <name>Nombre o ID de proyecto (obligatorio)
--priority <level>critical, high, medium o low
--assignee <name>Nombre del responsable o me
--description <text>Descripción de la tarea
--due <date>Fecha límite (YYYY-MM-DD)
--hours <n>Horas estimadas

Actualizar una Tarea

# Change status
apollo task update <id> -s in_progress

# Change priority and assignee
apollo task update <id> --priority critical --assignee "carlos"

# Update description
apollo task update <id> --description "Updated requirements: also handle refresh tokens"

# Set due date and estimated hours
apollo task update <id> --due 2026-04-01 --hours 8
Opciones:
FlagDescripción
-s, --status <status>Nuevo estado
--priority <level>Nueva prioridad
--assignee <name>Nuevo responsable
--description <text>Nueva descripción
--due <date>Nueva fecha límite (YYYY-MM-DD)
--hours <n>Nuevas horas estimadas

Acciones Rápidas

# Mark as done
apollo task done <id-or-title>

# Assign to someone
apollo task assign <id-or-title> "Ian"

Operaciones en Lote

Para gestionar varias tareas a la vez, el CLI proporciona comandos en lote que operan sobre conjuntos de tareas filtrados por proyecto, estado o IDs explícitos.

Actualización de Estado en Lote

Cambia el estado de varias tareas a la vez:
# By explicit IDs
apollo task bulk-status -s done --ids "id1,id2,id3"

# By project + current status filter
apollo task bulk-status -s in_progress -p "Apollo" --current-status todo

# Move all blocked tasks in a project to todo
apollo task bulk-status -s todo -p "Apollo" --current-status blocked
Opciones:
FlagDescripción
-s, --status <status>Nuevo estado a establecer (obligatorio)
--ids <id1,id2,...>IDs de tareas separados por coma
-p, --project <name>Filtrar por proyecto
--current-status <status>Solo actualizar tareas con este estado actual

Asignación en Lote

Asigna varias tareas a un miembro del equipo:
# Assign specific tasks
apollo task bulk-assign -a me --ids "id1,id2"

# Assign all unassigned tasks in a project
apollo task bulk-assign -a "Ian" -p "Apollo" --unassigned-only
Opciones:
FlagDescripción
-a, --assignee <name>Nombre del responsable o me (obligatorio)
--ids <id1,id2,...>IDs de tareas separados por coma
-p, --project <name>Filtrar por proyecto
--unassigned-onlySolo asignar tareas sin responsable actual

Creación en Lote

Crea varias tareas a la vez desde un archivo JSON:
# From a JSON file
apollo task bulk-create -p "Apollo" --file tasks.json
El archivo JSON debe contener un array de objetos de tarea:
[
  { "title": "Set up CI pipeline", "status": "todo", "priority": "high" },
  { "title": "Write unit tests", "status": "todo" },
  { "title": "Update documentation", "status": "backlog" }
]
Cada objeto de tarea puede incluir: title, status, priority, description, due_date, estimated_hours.

Salida JSON

Todos los comandos soportan --json para salida estructurada:
apollo task list --json
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Fix authentication bug",
    "status": "in_progress",
    "priority": "high",
    "project_id": "...",
    "assigned_to": "..."
  }
]

Ejemplos con Piping

# Count tasks by status
apollo task list -p "Apollo" --json | jq 'group_by(.status) | map({status: .[0].status, count: length})'

# Get titles of blocked tasks
apollo task list -s blocked --json | jq '.[].title'