cleo session
Work session lifecycle (start, end, status, gc for garbage collection)
Agent Relevance: High - Frequently used by LLM agents
Synopsis
cleo session <start|end|status|suspend|resume|close|list|show|switch|gc> [OPTIONS]
Subcommands
| Subcommand | Description |
|---|
start | Run cleo session start --help for details |
end | Run cleo session end --help for details |
status | Run cleo session status --help for details |
suspend | Run cleo session suspend --help for details |
resume | Run cleo session resume --help for details |
close | Run cleo session close --help for details |
list | Run cleo session list --help for details |
show | Run cleo session show --help for details |
switch | Run cleo session switch --help for details |
gc | Run cleo session gc --help for details |
Options
| Option | Description |
|---|
--format | Output format: text, json |
--quiet | Suppress output, return only essential data |
--dry-run | Preview changes without applying |
--force | Force operation without confirmation |
--verbose | Show detailed output |
--orphans | See cleo session --help for details |
--stale | See cleo session --help for details |
This command supports JSON output via --json flag for LLM agent integration.
Examples
Exit Codes
| Code | Meaning | Recoverable |
|---|
0 | Success | No |
4 | Resource not found | No |
101 | Already exists | No |
See Also