Claude Code Integration

Use Apollo CLI as a Claude Code skill for AI-assisted development workflows.

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

Command	Usage
apollo task list	List and filter tasks by project, status, assignee
apollo task mine	Shortcut for all tasks assigned to the current user
apollo task view <ref>	Get full task details
apollo task create	Create 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-status	Batch status update by IDs or project/status filter
apollo task bulk-assign	Batch assign tasks to a user
apollo task bulk-create	Create multiple tasks from a JSON file

Release Commands

Command	Usage
apollo release list	List releases, optionally filtered by project
apollo release view <ref>	Release details with task progress
apollo release create	Create 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

Command	Usage
apollo epic list -p <project>	List epics in a project
apollo epic view <name>	Epic details with release/task stats
apollo epic create	Create 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

Command	Usage
apollo task start <ref>	Start working on a task — creates git branch + marks in_progress
apollo task stop	Stop current task — stashes WIP, records elapsed time
apollo task current	Show the currently active task
apollo task next	Show 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 list	List 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 show	Show current default project
apollo context clear	Clear the default project

Project Commands

Command	Usage
apollo project list	List 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

Command	Usage
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 create	Create 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

Command	Usage
apollo note list	List personal notes
apollo note view <title>	View a note with full content
apollo note search <query>	Search notes by title or content
apollo note create	Create a note with optional folder
apollo note update <title>	Update a note’s content, title, or folder
apollo note folders	List note folders

Reminders

Command	Usage
apollo reminder list	List pending reminders
apollo reminder create	Create 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

Command	Usage
apollo flashcard list	List flashcards (use --due for only due cards)
apollo flashcard view <id>	View a card with SM-2 stats
apollo flashcard create	Create a new flashcard
apollo flashcard due	Count and preview due cards
apollo flashcard review --json	Output due cards as JSON for non-interactive review

Other Commands

Command	Usage
apollo ai "<prompt>"	Query Apollo Brain
apollo status	Personal dashboard — tasks, releases, blockers
apollo whoami	Check 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

Variable	Description
APOLLO_TOKEN	JWT token for authentication (skips interactive login)
APOLLO_API_URL	Override 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..."