Skip to main content

​
Usage

codaph timeline [options]
Reads and displays timeline events from the local Codaph mirror. Timeline events include agent prompts, reasoning, tool calls, file edits, and completions.

​
Options

​
--cwd
string
Working directory path. Defaults to current directory.
​
--session-id
string
Filter events to a specific session ID.
​
--thread-id
string
Filter events to a specific thread ID within a session.
​
--actor-id
string
Filter events by actor/contributor ID.
​
--from
string
ISO timestamp lower bound for filtering events.
​
--to
string
ISO timestamp upper bound for filtering events.
​
--item-type
string
Filter by event type (e.g., prompt, completion, tool_call, edit).
​
--offset
integer
default:"0"
Skip the first N events in results.
​
--limit
integer
default:"200"
Maximum number of events to return (1-1000).
​
--timeline-limit
integer
default:"1200"
Alias for --limit.
​
--json
boolean
default:"false"
Output results in JSON format.
​
--repo-id
string
Filter events by repository ID.

​
Examples

​
View recent timeline events

codaph timeline --limit 50

​
View timeline for specific session

codaph timeline --session-id ses_abc123

​
View timeline with time filter

codaph timeline --from 2026-03-01T00:00:00Z --to 2026-03-02T00:00:00Z

​
View timeline for specific actor

codaph timeline --actor-id developer --limit 100

​
JSON Output Format

{
  "cwd": "/Users/dev/project",
  "repoId": "owner/repo",
  "filter": {
    "repoId": "owner/repo",
    "sessionId": "ses_abc123"
  },
  "offset": 0,
  "limit": 200,
  "total": 156,
  "returned": 156,
  "truncated": false,
  "events": [
    {
      "eventId": "evt_xyz789",
      "source": "codex_sdk",
      "repoId": "owner/repo",
      "actorId": "developer",
      "sessionId": "ses_abc123",
      "threadId": "thread_001",
      "ts": "2026-03-01T10:00:00.000Z",
      "eventType": "prompt",
      "payload": {
        "content": "Fix the login bug"
      }
    }
  ]
}

​
Event Types

  • prompt - User prompt to the agent
  • completion - Agent response/completion
  • tool_call - Agent tool invocation
  • edit - File edit operation
  • reasoning - Agent reasoning/thinking
  • error - Error event

Build docs developers (and LLMs) love

Get started for freeTalk to us