CLI Commands

CLI Command Reference

Complete reference for all Paean CLI commands, from interactive chat to autonomous workers.

Interactive Mode

The default mode for day-to-day assistance. Chat with an AI agent that understands your project context.

Start Chat
$ paean# Start interactive chat
$ paean --plan# With project analysis

Tip: Use --plan mode for complex projects. It analyzes your codebase structure before starting.

Autonomous Worker

Offload long-running or complex tasks to the background worker for 24/7 execution.

Quick Prompt

Execute a task without entering a chat session. The supervisor analyzes your request and decides the best execution strategy.

$ paean prompt "Refactor the auth module"
$ paean prompt "Fix login bug" --executor cursor
$ paean prompt "Refactor, test, build" --chain

Continuous Worker

Start a persistent worker that polls for and executes tasks continuously.

$ paean worker start
Options: --interval <ms> --max-retries <n> --no-verification

Available Executors

ExecutorUse Case
internalBuilt-in Paean agent (default)
claudeComplex logic via Claude CLI
cursorContext-aware code edits
geminiLarge context analysis

Conversation History

Manage and resume previous conversations. All conversations sync to your Paean App workspace.

$ paean ls# List recent conversations
$ paean ls -n 50# List more
$ paean resume# Resume latest
$ paean resume 8f3a9b2c# Resume specific

Utility Commands

Context Generation

Generate a comprehensive context file for AI agents.

$ paean context -o .agent/context.md
$ paean context --json

Task Validation

Verify if pending tasks have been completed by recent changes.

$ paean validate
$ paean validate --auto-complete

Observability

Debug and analyze agent performance with built-in tracing.

$ paean trace --latest
$ paean trace --report

Next Steps