Session JSON Format

Session Status File

Each session has a JSON file at ~/.claude-sessions/<tmux-session-name>.json.

Full Schema

{
  "tmux_session": "my-session",
  "status": "working",
  "message": "Implementing login feature",
  "cwd": "/home/user/projects/app",
  "timestamp": 1738972800,
  "git": {
    "branch": "feature/login",
    "dirty": true,
    "ahead": 3,
    "behind": 0,
    "last_commit": "abc1234 Add login form",
    "remote": "origin",
    "pr_num": 42,
    "fetched_at": 1738972800
  },
  "metrics": {
    "started": 1738970000,
    "total_seconds": 2800,
    "working_seconds": 2400,
    "waiting_seconds": 400,
    "tools": {
      "Read": 15,
      "Write": 8,
      "Bash": 5,
      "Grep": 3
    },
    "recent_tools": ["Read", "Write", "Bash", "Read", "Grep"]
  },
  "tokens": {
    "input": 45000,
    "output": 12000,
    "total": 57000
  },
  "team": {
    "name": "my-project",
    "agents": [
      {
        "name": "researcher",
        "status": "working",
        "timestamp": 1738972800
      },
      {
        "name": "implementer",
        "status": "idle",
        "timestamp": 1738972850
      }
    ]
  }
}

Required Fields

Field	Type	Description
tmux_session	string	tmux session name (used as unique key)
status	string	Current session status
message	string	Status message or question
cwd	string	Working directory path
timestamp	int64	Unix timestamp of last status update

Optional Fields

Field	Type	Description
git	object	Git repository information
metrics	object	Time and tool metrics
tokens	object	Token usage from transcripts
team	object	Agent team information

Status Values

See Status Icons for the complete list of valid status values.

Task Provider Output

Task providers output JSON to stdout:

{
  "groups": [
    {
      "id": "1",
      "title": "Sprint 1",
      "status": "in_progress",
      "url": "https://github.com/org/repo/milestone/1",
      "tasks": [
        {
          "id": "1-1",
          "title": "Fix login bug",
          "status": "todo",
          "assignee": "alice",
          "labels": ["bug", "auth"],
          "priority": 1,
          "url": "https://github.com/org/repo/issues/42",
          "created": "2026-01-01T00:00:00Z",
          "updated": "2026-01-02T00:00:00Z"
        }
      ]
    }
  ]
}