Quick Start
Get CLEO installed and managing your first task in under 5 minutes.
TL;DR - Just Install It
curl -fsSL https://github.com/kryptobaseddev/cleo/releases/latest/download/install.sh | bash
--force:curl -fsSL https://github.com/kryptobaseddev/cleo/releases/latest/download/install.sh | bash -s -- --force
- Download install.sh
- Open Terminal and run:
bash ~/Downloads/install.sh
git clone https://github.com/kryptobaseddev/cleo.git && cd cleo && ./installer/install.sh --dev
The installer automatically detects missing dependencies (jq, flock) and offers to install them. On macOS, it auto-detects Homebrew Bash if your system Bash is below version 4.
Initialize Your Project
cd /path/to/your/project
cleo init
.cleo/ directory with task files and auto-injects instructions into CLAUDE.md.
Verify Installation
cleo version
cleo validate
Your First Task
cleo add "Fix login bug" --priority high --labels bug,auth
Essential Commands
| Command | Description | Example |
|---|
cleo add | Create a task | cleo add "Task title" |
cleo list | View tasks | cleo list --status pending |
cleo complete | Mark done | cleo complete T001 |
cleo focus set | Set active task | cleo focus set T001 |
cleo dash | Project overview | cleo dash |
Daily Workflow
# Morning: Start your session
cleo session start
cleo list --status pending
cleo focus set T001
# During work: Track progress
cleo update T001 --notes "Fixed validation logic"
cleo complete T001
cleo focus set T002
# Evening: Clean up
cleo archive
cleo session end
Use ct as a shorthand alias for cleo. Install shell aliases with source ~/.cleo/completions/bash-completion.sh.
Next Steps
