Personal Space

Manage notes, reminders, and flashcards with spaced repetition — all from the terminal.

Overview

Personal Space commands manage your private data — notes, reminders, and flashcards. These are scoped to your authenticated user and are not visible to other team members.

---

Notes

Personal notes with folder organization. No project scope required — notes belong to you.

List Notes

# All notes
apollo note list

# Filter by folder
apollo note list --folder "Daily notes"

# Limit results
apollo note list --limit 20

View a Note

apollo note view "Meeting notes"

Shows the note’s title, folder, version, and full content.

Search Notes

apollo note search "architecture"
apollo note search "deployment" --limit 10

Searches across note titles and content (case-insensitive).

Create a Note

# With inline content
apollo note create -t "Sprint Retro" --content "## What went well\n- Shipped on time"

# From a file
apollo note create -t "Design Doc" --file ./design.md

# In a folder
apollo note create -t "Daily 2026-02-20" --content "..." --folder "Daily notes"

Options:

Flag	Description
-t, --title <title>	Note title (required)
--content <text>	Note content
--file <path>	Read content from a file
--folder <name>	Place in a folder

Update a Note

# Update content
apollo note update "Sprint Retro" --content "Updated retro notes..."

# Move to a folder
apollo note update "Sprint Retro" --folder "Retros"

# Rename
apollo note update "Sprint Retro" -t "Sprint 12 Retrospective"

List Folders

apollo note folders

---

Reminders

Time-based reminders with priority levels and optional recurrence.

List Reminders

# Pending reminders only (default)
apollo reminder list

# Include completed and dismissed
apollo reminder list --all

Create a Reminder

# Basic reminder
apollo reminder create -t "Deploy v2" --at "2026-03-15T09:00"

# With priority and recurrence
apollo reminder create \
  -t "Weekly standup prep" \
  --at "2026-03-17T08:30" \
  --priority 1 \
  --recurrence weekly

Options:

Flag	Description
-t, --title <title>	Reminder title (required)
--at <datetime>	When to remind (ISO 8601 format, required)
--description <text>	Additional details
--priority <1-3>	1 = high, 2 = medium, 3 = low
--recurrence <type>	daily, weekly, or monthly

Manage Reminders

# Mark as completed
apollo reminder complete <id>

# Snooze for 30 minutes (default)
apollo reminder snooze <id>

# Snooze for a specific duration
apollo reminder snooze <id> --minutes 60

# Snooze until a specific time
apollo reminder snooze <id> --until "2026-03-16T10:00"

# Dismiss (won't remind again)
apollo reminder dismiss <id>

# Permanently delete
apollo reminder delete <id>

---

Flashcards

Spaced repetition flashcards using the SM-2 algorithm. Create cards, track review intervals, and study from the terminal.

List Flashcards

# All flashcards
apollo flashcard list

# Only cards due for review
apollo flashcard list --due

# Limit results
apollo flashcard list --limit 20

View a Flashcard

apollo flashcard view <id>

Shows front, back, and SM-2 stats (ease factor, interval, repetitions, next review date).

Create a Flashcard

apollo flashcard create \
  --front "What is RLS?" \
  --back "Row-Level Security — a PostgreSQL feature that restricts which rows a user can access based on policies."

New cards start with default SM-2 parameters and are immediately due for review.

Check Due Cards

apollo flashcard due

Shows the count of cards due for review and previews the first few.

Review Flashcards

Interactive review session — the CLI shows the front of each due card, waits for you to think, then reveals the back and asks you to rate your recall:

apollo flashcard review

Card 1 of 5
────────────────────────────
FRONT: What is RLS?

Press Enter to reveal...

BACK: Row-Level Security — a PostgreSQL feature that restricts
      which rows a user can access based on policies.

Rate your recall:
  1 = Complete blackout
  2 = Wrong, but recognized after seeing answer
  3 = Correct with difficulty
  4 = Perfect recall

Your rating [1-4]:

The SM-2 algorithm adjusts the card’s review interval based on your rating:

Rating	Effect
1-2	Reset interval to 1 day (card needs relearning)
3	Increase interval slightly (correct but difficult)
4	Increase interval significantly (easy recall)

In --json mode, apollo flashcard review --json skips the interactive flow and outputs the list of due cards as JSON — useful for building custom review UIs or Claude Code integrations.

---

JSON Output

All personal space commands support --json:

apollo note list --json
apollo reminder list --json
apollo flashcard due --json

Piping Examples

# Get all note titles
apollo note list --json | jq '.[].title'

# Count due flashcards
apollo flashcard due --json | jq '.due_count'

# Export a note to a file
apollo note view "Design Doc" --json | jq -r '.content' > design.md