Perch/schema/session.json at main · ReScienceLab/Perch · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://perch.app/schema/session.json",
  "title": "PerchSession",
  "description": "A single agent session entry saved by a Perch /perch command.",
  "type": "object",
  "required": [
    "id",
    "agent",
    "session_id",
    "working_dir",
    "title",
    "status",
    "created_at",
    "resume_cmd"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for this Perch entry (uuidgen, lowercase)."
    },
    "agent": {
      "type": "string",
      "enum": ["claude", "codex", "pi", "windsurf", "cursor", "trae", "droid", "goose", "opencode", "kiro", "amp"],
      "description": "The AI agent that created this session entry."
    },
    "session_id": {
      "type": "string",
      "description": "Native session identifier from the agent runtime."
    },
    "working_dir": {
      "type": "string",
      "description": "Absolute path of the working directory when /perch was invoked."
    },
    "title": {
      "type": "string",
      "maxLength": 60,
      "description": "Short human-readable title (≤60 chars) describing the session."
    },
    "note": {
      "type": "string",
      "description": "Optional freeform note provided by the user as the /perch argument."
    },
    "priority": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "description": "Session priority. Defaults to medium."
    },
    "status": {
      "type": "string",
      "enum": ["pending", "in-progress", "done"],
      "description": "Resumption status of the session."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 UTC timestamp of when this entry was created."
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 UTC timestamp of the most recent /perch update for this entry. Omitted until the first update."
    },
    "resume_cmd": {
      "type": "string",
      "description": "Shell command to resume this session (e.g. claude --resume <session_id>)."
    }
  },
  "additionalProperties": false
}