Command Reference
CLEO provides 53 commands organized by function. All commands output JSON when piped.
Use cleo help <command> for detailed help on any command.
Quick Reference
Task Management
Create, update, complete, and manage tasks
Session & Focus
Multi-session support and focus tracking
Analysis
Task triage, dashboards, and insights
Hierarchy
Epic, task, subtask organization
Maintenance
Backup, restore, validation, upgrades
Integration
Export, import, research integration
Command Categories
Task Management
| Command | Description |
|---|
| add | Create a new task |
| update | Modify task properties |
| complete | Mark task as done |
| delete | Cancel/soft-delete task |
| reopen | Restore completed task |
| list | View tasks with filters |
| show | Full task details |
| find | Search tasks |
Session & Focus
| Command | Description |
|---|
| session | Manage work sessions |
| focus | Set/view active task |
| context | Monitor context usage |
Analysis
| Command | Description |
|---|
| analyze | Task triage with scoring |
| dash | Project dashboard |
| next | Suggest next task |
| blockers | Show blocked tasks |
| deps | Dependency overview |
Hierarchy
| Command | Description |
|---|
| tree | Hierarchical view |
| reparent | Move task to new parent |
| promote | Make task root-level |
Maintenance
| Command | Description |
|---|
| validate | Check data integrity |
| backup | Create backup |
| restore | Restore from backup |
| upgrade | Update schemas |
| doctor | Health diagnostics |
Common Patterns
# Start a work session
cleo session start --scope epic:T001 --auto-focus
# Add task with full metadata
cleo add "Implement feature" --priority high --phase core
# Complete with notes
cleo complete T001 --notes "Implemented and tested"
# View project status
cleo dash --compact
All commands support --help for detailed usage information.
