Releases & Projects

Browse projects, manage releases, assign tasks to releases, and export project data.

Release Commands

List Releases

# All releases
apollo release list

# Filter by project
apollo release list -p "Apollo"

# Filter by status
apollo release list -p "Apollo" -s in_progress

View Release Details

Shows release metadata, task breakdown by status, and completion percentage:

apollo release view "v2.1.0"

Example output

v2.1.0
────────────────────────────────────────────────────────────
  Version: 2.1.0
  Status:  In Progress
  Date:    3/1/2026
  Project: Delfin One
  ID:      550e8400-...

  Tasks (18)
  Progress: 67% — 12/18 done
  In Progress: 3 | Todo: 2 | Blocked: 1

  In Progress    #142 Fix authentication bug
  In Progress    #147 Add retry logic
  Done           #130 Implement login flow
  ...

Create a Release

apollo release create \
  -n "v2.2.0" \
  -p "Delfin One" \
  -v "2.2.0" \
  -d 2026-04-01 \
  --description "Q2 feature release"

Options:

Flag	Description
-n, --name <name>	Release name (required)
-p, --project <name>	Project name or ID (required)
-v, --version <version>	Version string (e.g., 2.2.0)
-d, --date <date>	Target release date (YYYY-MM-DD)
--description <desc>	Release description

Update a Release

Update any release field after creation:

# Change status
apollo release update "v2.2.0" -s in_progress

# Update target date and description
apollo release update "v2.2.0" -d 2026-05-01 --description "Pushed to May"

# Rename
apollo release update "v2.2.0" -n "Q2 Release"

Options:

Flag	Description
-n, --name <name>	New release name
-v, --version <version>	New version string
-s, --status <status>	New status (planned, in_progress, released)
-d, --date <date>	New target date (YYYY-MM-DD)
--description <desc>	New description

Assign Tasks to a Release

Link tasks to a release by explicit IDs or by filter:

# Assign specific tasks
apollo release assign-tasks "v2.2.0" --ids "id1,id2,id3"

# Assign all unassigned todo tasks in a project
apollo release assign-tasks "v2.2.0" -p "Apollo" -s todo --unassigned-only

Options:

Flag	Description
--ids <id1,id2,...>	Comma-separated task IDs to assign
-p, --project <name>	Filter tasks by project
-s, --status <status>	Filter tasks by status
--unassigned-only	Only assign tasks not already in a release

---

Project Commands

List Projects

apollo project list

View Project Details

Shows task summary stats (by status) for the project:

apollo project view "Apollo"

Export Project Data

Export project information in multiple formats. Useful for reports, backups, and integrations:

# Export as JSON (default)
apollo project export "Apollo" --include-tasks --include-releases

# Export tasks as CSV
apollo project export "Apollo" --include-tasks --format csv > tasks.csv

# Export as Markdown
apollo project export "Apollo" --include-tasks --include-releases --format markdown

Options:

Flag	Description
--format <type>	Output format: json (default), csv, markdown
--include-tasks	Include all project tasks in the export
--include-releases	Include all project releases in the export

Format details:

Format	Contents
JSON	Full structured data — project + tasks + releases as JSON
CSV	Tasks only — one row per task with columns: ID, Title, Status, Priority, Assignee, Due Date
Markdown	Human-readable report with project metadata, task table, and release list

---

Status Dashboard

The status command gives you a personal overview — your tasks, upcoming deadlines, and blockers across all projects:

apollo status