Skip to main content

​
Usage

codaph sessions list [options]
Lists all captured agent sessions from the local Codaph mirror (.codaph/ directory). Sessions represent individual agent coding runs captured from Codex, Claude Code, or Gemini CLI.

​
Options

​
--cwd
string
Working directory path. Defaults to current directory.
​
--json
boolean
default:"false"
Output results in JSON format instead of human-readable text.
​
--limit
integer
default:"200"
Maximum number of sessions to return (1-5000).
​
--repo-id
string
Filter sessions by repository ID. Auto-detected from git remote or project settings if not specified.

​
Examples

​
List recent sessions

codaph sessions list

​
List sessions with JSON output

codaph sessions list --json

​
List sessions for specific project

codaph sessions list --cwd /path/to/project

​
JSON Output Format

{
  "cwd": "/Users/dev/project",
  "repoId": "owner/repo",
  "total": 42,
  "sessions": [
    {
      "sessionId": "ses_abc123",
      "repoId": "owner/repo",
      "actorId": "developer",
      "source": "codex_sdk",
      "startedAt": "2026-03-01T10:00:00.000Z",
      "lastActivityAt": "2026-03-01T10:45:00.000Z",
      "eventCount": 156,
      "threadCount": 3
    }
  ],
  "truncated": false
}

Build docs developers (and LLMs) love

Get started for freeTalk to us