Vai al contenuto principale

Panoramica

I comandi attività ti permettono di gestire le tue attività Apollo senza aprire l’applicazione web. Tutti i comandi supportano la risoluzione fuzzy dei nomi — puoi fare riferimento alle attività per titolo, corrispondenza parziale o UUID.

Comandi

Elencare le Attività

# 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
Opzioni:
FlagDescrizione
-p, --project <name>Filtrare per nome o ID progetto
-s, --status <status>Filtrare per stato: backlog, todo, in_progress, blocked, done
-a, --assignee <name>Filtrare per responsabile (usa me per te stesso)
--release <name>Filtrare per nome release (corrispondenza fuzzy)
--specialty <name>Filtrare per specialità (es: frontend, back-end, ai)
--task-type <name>Filtrare per tipo di attività (es: feature, bug, chore)
--unassignedMostrare solo attività senza responsabile
--due-before <date>Attività con scadenza entro una data (YYYY-MM-DD)
--limit <n>Massimo risultati (predefinito: 50)

Visualizzare i Dettagli dell’Attività

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

# By UUID
apollo task view 550e8400-e29b-41d4-a716-446655440000
Mostra tutti i dettagli dell’attività: stato, priorità, responsabile, progetto, descrizione, date e dipendenze.

Creare un’Attività

# 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
Opzioni:
FlagDescrizione
-t, --title <title>Titolo dell’attività (obbligatorio)
-p, --project <name>Nome o ID del progetto (obbligatorio)
--priority <level>critical, high, medium o low
--assignee <name>Nome del responsabile o me
--description <text>Descrizione dell’attività
--due <date>Data di scadenza (YYYY-MM-DD)
--hours <n>Ore stimate

Aggiornare un’Attività

# 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
Opzioni:
FlagDescrizione
-s, --status <status>Nuovo stato
--priority <level>Nuova priorità
--assignee <name>Nuovo responsabile
--description <text>Nuova descrizione
--due <date>Nuova data di scadenza (YYYY-MM-DD)
--hours <n>Nuove ore stimate

Azioni Rapide

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

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

Operazioni in Blocco

Per gestire più attività contemporaneamente, il CLI fornisce comandi in blocco che operano su insiemi di attività filtrati per progetto, stato o ID espliciti.

Aggiornamento Stato in Blocco

Cambia lo stato di più attività contemporaneamente:
# 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
Opzioni:
FlagDescrizione
-s, --status <status>Nuovo stato da impostare (obbligatorio)
--ids <id1,id2,...>ID attività separati da virgola
-p, --project <name>Filtrare per progetto
--current-status <status>Aggiornare solo attività con questo stato attuale

Assegnazione in Blocco

Assegna più attività a un membro del team:
# 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
Opzioni:
FlagDescrizione
-a, --assignee <name>Nome del responsabile o me (obbligatorio)
--ids <id1,id2,...>ID attività separati da virgola
-p, --project <name>Filtrare per progetto
--unassigned-onlyAssegnare solo attività senza responsabile attuale

Creazione in Blocco

Crea più attività contemporaneamente da un file JSON:
# From a JSON file
apollo task bulk-create -p "Apollo" --file tasks.json
Il file JSON deve contenere un array di oggetti attività:
[
  { "title": "Set up CI pipeline", "status": "todo", "priority": "high" },
  { "title": "Write unit tests", "status": "todo" },
  { "title": "Update documentation", "status": "backlog" }
]
Ogni oggetto attività può includere: title, status, priority, description, due_date, estimated_hours.

Output JSON

Tutti i comandi supportano --json per output strutturato:
apollo task list --json
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Fix authentication bug",
    "status": "in_progress",
    "priority": "high",
    "project_id": "...",
    "assigned_to": "..."
  }
]

Esempi 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'