Vai al contenuto principale

​
Panoramica

I comandi workflow trasformano l’Apollo CLI in un gestore di lavoro pensato per gli sviluppatori. Avvia un’attività e ottieni automaticamente un branch git. Lascia che il punteggio di urgenza ti dica su cosa lavorare. Salva i tuoi filtri preferiti. Imposta un progetto predefinito per smettere di digitare -p ovunque.
Tutti i comandi workflow supportano --json per scripting e integrazione con Claude Code.

​
Avvia / Ferma / Attuale

​
apollo task start <id>

Risolve un’attività, crea un branch git, la segna come in_progress e traccia la tua sessione attiva. 
# 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
predefinito:"main"
Branch base da cui creare
​
--branch
string
Sovrascrivere il nome del branch generato automaticamente
​
--no-branch
boolean
predefinito:"false"
Saltare la creazione del branch git, aggiornare solo lo stato dell’attività
Cosa succede:
  1. Genera il nome del branch: feat/<shortId>-<slugified-title>
  2. Crea e passa al branch (o passa al branch se già esistente)
  3. Salva i metadati dell’attività come configurazione del branch git
  4. Segna l’attività come in_progress in Apollo
  5. Ti assegna automaticamente l’attività se non assegnata
  6. Salva la sessione attiva localmente per stop e current

​
apollo task stop [id]

Ferma la tua sessione attiva. Mette in stash le modifiche non committate, aggiorna lo stato e mostra il tempo trascorso. 
# 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
predefinito:"false"
Segnare l’attività come done invece di tornare a todo
​
--no-stash
boolean
predefinito:"false"
Saltare git stash anche se ci sono modifiche non committate

​
apollo task current

Mostra l’attività attualmente attiva con il tempo trascorso. 
apollo task current
# Working on: Fix authentication bug
#   Project: Apollo
#   Branch:  feat/a1b2c3d4-fix-authentication-bug
#   Elapsed: 1h 23m
#   ID:      a1b2c3d4-...

​
Prossima Attività (Ranking Intelligente)

​
apollo task next

Mostra le tue attività a priorità più alta ordinate per un punteggio di urgenza ponderato. Ispirato al sistema dei coefficienti di urgenza di 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
Limitare a un progetto specifico
​
-n, --count
number
predefinito:"5"
Numero di attività da mostrare
​
--explain
boolean
predefinito:"false"
Mostrare il dettaglio del punteggio per ogni attività

​
Algoritmo di Punteggio

Ogni attività viene valutata su 6 fattori con pesi diversi:
FattorePesoMax GrezzoDescrizione
Priority4x20critical=20, high=15, medium=10, low=5
Due Date3x20overdue=20, today=18, this week=12, this month=6
Unblocked2x10+10 se nessun blocco, -20 se bloccata
Impact2x20+5 per attività che sblocchi (max 4)
Age1x50-5 basato sui giorni dalla creazione
Status1x8in_progress=8, todo=5, blocked=0
Il punteggio grezzo viene normalizzato a 0-100. Usa --explain per vedere il dettaglio esatto.

​
Filtri Salvati

Salva le combinazioni di filtri attività usate frequentemente e riproducile con un singolo 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 stato (separato da virgola)
​
--priority
string
Filtro priorità (separato da virgola)
​
-a, --assignee
string
Nome del responsabile o me
​
-p, --project
string
Nome del progetto
​
--release
string
Nome della release
​
--unassigned
boolean
Solo attività non assegnate
​
--due-before
string
Con scadenza prima di
​
--limit
string
Massimo risultati

​
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>

Riproduce il filtro salvato eseguendo apollo task list con le flag memorizzate. 
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"
I filtri sono salvati localmente in ~/.apollo/apollo-local.json e persistono tra le sessioni.

​
Contesto di Progetto

Imposta un progetto predefinito per non dover digitare -p "NomeProgetto" ad ogni 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.
Comandi che rispettano il contesto: task list, release list, epic list, kb list, kb search, kb folders. Una flag -p esplicita sovrascrive sempre il contesto predefinito.

​
Dipendenze delle Attività

​
apollo task deps [id]

Visualizza l’albero delle dipendenze di un’attività — chi ti blocca e chi sblocchi tu. 
# 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
predefinito:"both"
up (solo bloccanti), down (solo dipendenti) o both
​
--depth
number
predefinito:"3"
Profondità massima di attraversamento
​
-p, --project
string
Mostrare tutte le catene di dipendenze in un progetto (senza necessità di ID attività)
Vista singola attività mostra un albero con icone di stato: 
  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 a livello di progetto mostra catene lineari: 
  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