Skip to main content

​
Usage

codaph diff <session-id> [options]
Summarizes file changes made during a Codaph session. Shows which files were created, modified, or deleted by the agent.

​
Arguments

​
session-id
string
required
The session ID to get diff summary for.

​
Options

​
--cwd
string
Working directory path. Defaults to current directory.
​
--path-filter
string
Filter results to files matching this path pattern.
​
--json
boolean
default:"false"
Output results in JSON format.
​
--repo-id
string
Repository ID. Auto-detected if not specified.

​
Examples

​
View diff summary for a session

codaph diff ses_abc123

​
Filter to specific path

codaph diff ses_abc123 --path-filter src/

​
Get JSON output

codaph diff ses_abc123 --json

​
JSON Output Format

{
  "cwd": "/Users/dev/project",
  "repoId": "owner/repo",
  "sessionId": "ses_abc123",
  "pathFilter": null,
  "count": 5,
  "files": [
    {
      "path": "src/auth/login.ts",
      "editCount": 3,
      "firstEditAt": "2026-03-01T10:15:00.000Z",
      "lastEditAt": "2026-03-01T10:30:00.000Z",
      "operation": "modified"
    },
    {
      "path": "src/auth/session.ts",
      "editCount": 1,
      "firstEditAt": "2026-03-01T10:20:00.000Z",
      "lastEditAt": "2026-03-01T10:20:00.000Z",
      "operation": "created"
    }
  ]
}

​
File Operations

  • created - File was created during the session
  • modified - Existing file was edited
  • deleted - File was removed

Build docs developers (and LLMs) love

Get started for freeTalk to us