Skip to main content

​
Overview

The apollo ai command connects you to Apollo Brain — the same AI assistant available in the web app, with all 160+ tools — directly from your terminal.

​
One-Shot Mode

Ask a question and get a streamed response: 
apollo ai "What tasks are blocked right now?"
The response streams in real-time, rendered as formatted markdown in your terminal.

​
Piping and Scripting

# Pipe to clipboard
apollo ai "Summarize this week's progress" | pbcopy

# Use in scripts
apollo ai "How many tasks are blocked?" --json
In --json mode, the AI response streams to stderr while the final structured result goes to stdout. This makes it safe to pipe without losing the streaming experience.

​
Interactive Chat Mode

For multi-turn conversations, use the --chat flag: 
apollo ai --chat
This opens a REPL with persistent conversation context: 
Apollo Brain — Interactive Chat
Type /quit to exit, /clear to reset context
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

You: What's the status of the Delfin One project?

Brain: Delfin One has 142 tasks total:
  - 72 completed (51%)
  - 12 in progress
  - 31 to do
  - 4 blocked

You: Assign #158 to Carlos and set it to high priority

Brain: I'd like to update task #158:
  - Assignee: Carlos Silva
  - Priority: High

  Approve?  [Y/n]

​
Chat Commands

CommandDescription
/quitExit the chat session
/clearReset conversation context
/historyShow conversation so far

​
Human-in-the-Loop

Write operations (create, update, delete) always require confirmation:
  • Interactive mode: Shows an approval prompt ([Y/n])
  • --json mode: Returns a requires_confirmation response — pass --confirm to auto-approve
# Auto-approve for scripts (use with caution)
apollo ai "Mark task #142 as done" --json --confirm

​
Examples

# Daily standup summary
apollo ai "Give me a standup summary: what I did yesterday, what I'm doing today, and any blockers"

# Sprint planning
apollo ai "Which unassigned tasks in the current sprint have the highest priority?"

# Release readiness
apollo ai "Is release v2.1.0 on track? What's the biggest risk?"

# Code context
git diff HEAD~3 | apollo ai "Summarize these changes and suggest which Apollo tasks they relate to"