Skip to main content

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

SubcommandDescription
startRun cleo session start --help for details
endRun cleo session end --help for details
statusRun cleo session status --help for details
suspendRun cleo session suspend --help for details
resumeRun cleo session resume --help for details
closeRun cleo session close --help for details
listRun cleo session list --help for details
showRun cleo session show --help for details
switchRun cleo session switch --help for details
gcRun cleo session gc --help for details

Options

OptionDescription
--formatOutput format: text, json
--quietSuppress output, return only essential data
--dry-runPreview changes without applying
--forceForce operation without confirmation
--verboseShow detailed output
--orphansSee cleo session --help for details
--staleSee cleo session --help for details
This command supports JSON output via --json flag for LLM agent integration.

Examples

cleo session

Exit Codes

CodeMeaningRecoverable
0SuccessNo
4Resource not foundNo
101Already existsNo

See Also