API Reference

Technical reference for CLEO schemas, exit codes, and output formats

API Reference

Technical documentation for integrating with CLEO.

Schemas

JSON Schema definitions for all data structures

Exit Codes

CLI exit codes and error handling

Output Formats

JSON, CSV, and human-readable formats

Configuration

config.json reference

Data Files

File	Purpose
.cleo/todo.json	Active tasks
.cleo/todo-archive.json	Completed tasks
.cleo/config.json	Configuration
.cleo/todo-log.json	Audit trail
.cleo/sessions.json	Session state

JSON Output

All commands output JSON when piped:

cleo list | jq '.tasks[0]'

Response envelope:

{
  "$schema": "...",
  "_meta": { "command": "list", "version": "0.60.0" },
  "success": true,
  "tasks": [...]
}

Never edit .cleo/*.json files directly. Use CLI commands only.