Skip to main content

​
Overview

The Apollo CLI ships with a Claude Code skill that teaches Claude how to use Apollo commands. This means you can manage your entire Apollo workspace from within Claude Code sessions — creating tasks, searching the knowledge base, taking notes, reviewing flashcards, and querying Brain without switching tools.

​
Setup

1

Install the CLI

cd apollo/cli
npm install && npx tsc
npm install -g .
2

Authenticate

apollo login
3

Install the skill

Copy the skill file to Claude Code’s skills directory:
mkdir -p ~/.claude/skills
cp apollo/cli/skill/apollo-tasks.md ~/.claude/skills/apollo-tasks.md
Or create it manually — see the Skill File Reference below.
Once installed, Claude Code automatically discovers the skill and uses it when you ask about tasks, projects, notes, reminders, or any Apollo-related request.

​
How It Works

The skill teaches Claude Code to:
  1. Check auth with apollo whoami before making requests
  2. Always use --json for structured, parseable output
  3. Resolve resources by name using the CLI’s fuzzy matching
  4. Choose the right command based on your natural language request
  5. Handle all domains — tasks, releases, KB, notes, reminders, flashcards

​
Example Session

You: What are my current tasks?

Claude: [Runs: apollo task mine --json]

        You have 6 active tasks across 2 projects:

        Delfin One (4 tasks):
        - Fix authentication bug — In Progress, High priority
        - Add retry logic — In Progress, Medium
        - Performance optimization — In Progress, Medium
        - Deploy staging — Blocked

        Apollo (2 tasks):
        - Add CSV export — To Do, Medium
        - Update API docs — To Do, Low

You: Bulk-move all Apollo todo tasks to in_progress

Claude: [Runs: apollo task bulk-status -s in_progress -p "Apollo" --current-status todo --json]

        Done. Updated 2 tasks in Apollo from todo to in_progress.

You: Search the KB for our deployment guide

Claude: [Runs: apollo kb search "deployment" -p "Apollo" --json]

        Found 2 matching pages:
        1. "Production Deployment Guide" (Architecture folder)
        2. "Staging Deploy Runbook" (Operations folder)

You: Create a note about today's standup

Claude: [Runs: apollo note create -t "Standup 2026-02-20" --content "..." --folder "Daily notes"]

        Created note: Standup 2026-02-20

​
Full Skill Command Reference

The skill exposes the following command groups to Claude Code:

​
Task Commands

CommandUsage
apollo task listList and filter tasks by project, status, assignee
apollo task mineShortcut for all tasks assigned to the current user
apollo task view <ref>Get full task details
apollo task createCreate a task with title, project, priority, assignee, description, due date
apollo task update <id>Update status, priority, assignee, description, due date, hours
apollo task done <ref>Mark a task as completed
apollo task assign <ref> <name>Assign a task to someone
apollo task bulk-statusBatch status update by IDs or project/status filter
apollo task bulk-assignBatch assign tasks to a user
apollo task bulk-createCreate multiple tasks from a JSON file

​
Release Commands

CommandUsage
apollo release listList releases, optionally filtered by project
apollo release view <ref>Release details with task progress
apollo release createCreate a new release
apollo release update <ref>Update release name, version, status, date, description
apollo release assign-tasks <ref>Assign tasks to a release by IDs or filter

​
Epic Commands

CommandUsage
apollo epic list -p <project>List epics in a project
apollo epic view <name>Epic details with release/task stats
apollo epic createCreate an epic with title, project, status, quarter
apollo epic update <name>Update epic title, status, description, quarter, color
apollo epic complete <name>Mark epic as completed
apollo epic archive <name>Archive an epic
apollo epic tasks <name>All tasks under an epic (via releases)

​
Workflow Commands

CommandUsage
apollo task start <ref>Start working on a task — creates git branch + marks in_progress
apollo task stopStop current task — stashes WIP, records elapsed time
apollo task currentShow the currently active task
apollo task nextShow highest-priority tasks ranked by urgency score
apollo task deps <ref>Show task dependency tree (upstream blockers + downstream)
apollo filter save <name>Save a named task filter from flags
apollo filter listList all saved filters
apollo filter run <name>Run a saved filter (delegates to task list)
apollo filter delete <name>Delete a saved filter
apollo context set <project>Set default project for all commands
apollo context showShow current default project
apollo context clearClear the default project

​
Project Commands

CommandUsage
apollo project listList accessible projects
apollo project view <ref>Project details with task summary stats
apollo project export <ref>Export project data as JSON, CSV, or Markdown

​
Knowledge Base Commands

CommandUsage
apollo kb list -p <project>List KB pages in a project
apollo kb view <title>View a KB page with full content
apollo kb search <query> -p <project>Search KB pages by title or content
apollo kb createCreate a new KB page
apollo kb update <title>Update a KB page’s content, title, or folder
apollo kb delete <title>Soft-delete a KB page
apollo kb folders -p <project>List KB folders

​
Personal Notes

CommandUsage
apollo note listList personal notes
apollo note view <title>View a note with full content
apollo note search <query>Search notes by title or content
apollo note createCreate a note with optional folder
apollo note update <title>Update a note’s content, title, or folder
apollo note foldersList note folders

​
Reminders

CommandUsage
apollo reminder listList pending reminders
apollo reminder createCreate a time-based reminder
apollo reminder complete <id>Mark a reminder as done
apollo reminder snooze <id>Snooze a reminder
apollo reminder dismiss <id>Dismiss a reminder
apollo reminder delete <id>Permanently delete a reminder

​
Flashcards

CommandUsage
apollo flashcard listList flashcards (use --due for only due cards)
apollo flashcard view <id>View a card with SM-2 stats
apollo flashcard createCreate a new flashcard
apollo flashcard dueCount and preview due cards
apollo flashcard review --jsonOutput due cards as JSON for non-interactive review

​
Other Commands

CommandUsage
apollo ai "<prompt>"Query Apollo Brain
apollo statusPersonal dashboard — tasks, releases, blockers
apollo whoamiCheck authentication status

​
Workflow Examples

​
After Implementing a Feature

You: I just finished the token refresh logic. Mark the task as done
     and check if anything was blocked by it.

Claude: [Runs: apollo task done "token refresh" --json]
        [Runs: apollo task list -s blocked --json]

        Marked "Fix authentication bug" as done.
        This unblocks 1 task:
        - "Deploy staging environment" — was blocked, now ready.
        Want me to move it to In Progress?

​
Knowledge Base Workflow

You: Create a KB page for our new API rate limiting rules

Claude: [Runs: apollo kb create -t "API Rate Limiting" -p "Apollo"
         --content "## Rate Limits\n..." --folder "Architecture" --json]

        Created KB page "API Rate Limiting" in the Architecture folder.

​
Study Session

You: How many flashcards are due?

Claude: [Runs: apollo flashcard due --json]

        You have 12 flashcards due for review.
        Want me to start a review session?

​
Morning Briefing

You: Give me a morning briefing — my tasks, any reminders, and due flashcards

Claude: [Runs: apollo task mine --json]
        [Runs: apollo reminder list --json]
        [Runs: apollo flashcard due --json]

        Morning Briefing:

        Tasks (6 active):
        - 3 in progress, 2 todo, 1 blocked

        Reminders (2 pending):
        - "Deploy v2" — due in 3 hours
        - "Weekly standup prep" — due tomorrow

        Flashcards: 8 due for review

​
Skill File Reference

The skill file is located at ~/.claude/skills/apollo-tasks.md. It contains:
  • Authentication check: apollo whoami before any command
  • Complete command reference for all 34+ CLI commands
  • Fuzzy name resolution documentation
  • JSON mode instructions for structured output
  • Workflow examples for common patterns
  • MCP server fallback when the CLI is unavailable
Claude Code reads this file at skill invocation time. Any updates to the file are picked up by new sessions immediately.

​
Environment Variables

VariableDescription
APOLLO_TOKENJWT token for authentication (skips interactive login)
APOLLO_API_URLOverride API endpoint (default: api.apol.dev)
For CI environments or remote Claude Code sessions, set APOLLO_TOKEN to avoid interactive auth: 
export APOLLO_TOKEN="eyJhbGciOiJIUzI1NiIs..."