Skip to main content

​
Usage

codaph inspect <session-id> [options]
Inspects detailed information for a captured agent session, including metadata, timeline events, and file changes.

​
Arguments

​
session-id
string
required
The session ID to inspect.

​
Options

​
--cwd
string
Working directory path. Defaults to current directory.
​
--json
boolean
default:"false"
Output results in JSON format.
​
--repo-id
string
Repository ID. Auto-detected if not specified.
​
--show-payload
boolean
default:"true"
Include full event payloads in output.

​
Examples

​
Inspect a session

codaph inspect ses_abc123

​
Inspect with JSON output

codaph inspect ses_abc123 --json

​
Inspect session in specific project

codaph inspect ses_abc123 --cwd /path/to/project

​
Output Format

The inspect command shows:
  • Session metadata (ID, actor, source, timestamps)
  • Event count and thread count
  • Timeline of events
  • File change summary

​
JSON Output Example

{
  "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,
  "events": [
    {
      "eventId": "evt_xyz789",
      "eventType": "prompt",
      "ts": "2026-03-01T10:00:00.000Z",
      "payload": {
        "content": "Fix the login bug"
      }
    }
  ],
  "files": [
    {
      "path": "src/auth/login.ts",
      "editCount": 3,
      "operation": "modified"
    }
  ]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us