@kurrent/kapacitor 0.5.9 → 0.5.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "kapacitor",
3
- "version": "0.5.9",
3
+ "version": "0.5.11",
4
4
  "description": "Records and visualizes Claude Code sessions via kapacitor CLI hooks"
5
5
  }
@@ -2,6 +2,5 @@
2
2
  "name": "kapacitor",
3
3
  "version": "1.6.0",
4
4
  "description": "Records and visualizes Codex CLI sessions via kapacitor CLI hooks",
5
- "skills": "./codex-skills/",
6
5
  "mcpServers": "./.codex-mcp.json"
7
6
  }
@@ -46,15 +46,15 @@ PR review context tools, available automatically when the agent is on a branch w
46
46
 
47
47
  Each hook pipes its JSON payload through the `kapacitor` CLI, which enriches it with git/PR info and forwards it to the server. A background watcher process streams transcript lines in real time.
48
48
 
49
- **Skills** — Slash commands for reviewing recorded sessions. Available on both harnesses (Claude reads `skills/`, Codex reads `codex-skills/`):
49
+ **Skills** — Slash commands for reviewing recorded sessions. Claude reads `skills/` (unprefixed folder names); Codex and Cursor read `~/.agents/skills/` (`kapacitor-*` prefixed folder names):
50
50
 
51
- - `kapacitor-recap` — Retrieve a structured summary of a session (user prompts, assistant responses, plans, file changes)
52
- - `kapacitor-errors` — Extract tool call errors from a session for post-session review and pattern detection
53
- - `kapacitor-validate-plan` — Verify that all planned items were completed
54
- - `kapacitor-disable` — Stop recording and delete all server data for the current session
55
- - `kapacitor-hide` — Hide the current session (owner-only visibility)
51
+ - `recap` / `kapacitor-recap` — Retrieve a structured summary of a session (user prompts, assistant responses, plans, file changes)
52
+ - `errors` / `kapacitor-errors` — Extract tool call errors from a session for post-session review and pattern detection
53
+ - `validate-plan` / `kapacitor-validate-plan` — Verify that all planned items were completed
54
+ - `disable` / `kapacitor-disable` — Stop recording and delete all server data for the current session
55
+ - `hide` / `kapacitor-hide` — Hide the current session (owner-only visibility)
56
56
 
57
- In Claude they're invoked as `/kapacitor:session-recap`, `/kapacitor:session-errors`, etc.
57
+ In Claude they're invoked as `/kapacitor:recap`, `/kapacitor:errors`, etc.
58
58
 
59
59
  ## Prerequisites
60
60
 
@@ -67,8 +67,9 @@ In Claude they're invoked as `/kapacitor:session-recap`, `/kapacitor:session-err
67
67
 
68
68
  ```bash
69
69
  kapacitor plugin install # Claude Code, user-wide
70
- kapacitor plugin install --codex # Codex CLI, user-wide
71
- kapacitor plugin install --project # current project only
70
+ kapacitor plugin install --codex # Codex CLI, user-wide (hooks + agent skills)
71
+ kapacitor plugin install --skills # Agent skills only (~/.agents/skills/), no Codex hooks
72
+ kapacitor plugin install --project # current project only (hooks scope; skills always user-wide)
72
73
  ```
73
74
 
74
75
  ### Option B: Interactive plugin manager
@@ -76,6 +77,8 @@ kapacitor plugin install --project # current project only
76
77
  - Claude Code: run `/plugin` inside a session and browse the **Installed** tab.
77
78
  - Codex CLI: `codex plugin marketplace add kurrent-io/kapacitor-cli` then enable from the marketplace.
78
79
 
80
+ > **Note:** Codex's native plugin loader installs the MCP servers only. To get hooks and agent skills, additionally run `kapacitor plugin install --codex`.
81
+
79
82
  ### Option C: Settings file (manual)
80
83
 
81
84
  Add to `.claude/settings.local.json` or `~/.claude/settings.json`:
@@ -117,32 +120,21 @@ kapacitor/
117
120
  plugin.json — Claude manifest (name, version, description)
118
121
  marketplace.json — Marketplace manifest for plugin discovery
119
122
  .codex-plugin/
120
- plugin.json — Codex manifest (refs ./.codex-mcp.json and ./codex-skills/)
123
+ plugin.json — Codex manifest (refs ./.codex-mcp.json)
121
124
  .mcp.json — Claude MCP servers (camelCase mcpServers shape)
122
125
  .codex-mcp.json — Codex MCP servers (snake_case mcp_servers shape)
123
126
  hooks/
124
127
  hooks.json — Hook definitions for all Claude lifecycle events
125
128
  skills/
126
- session-recap/
127
- SKILL.md — /kapacitor:session-recap skill (Claude)
128
- session-errors/
129
+ recap/
130
+ SKILL.md — /kapacitor:recap skill (Claude)
131
+ errors/
129
132
  SKILL.md
130
133
  validate-plan/
131
134
  SKILL.md
132
- session-disable/
133
- SKILL.md
134
- session-hide/
135
- SKILL.md
136
- codex-skills/
137
- kapacitor-recap/
138
- SKILL.md — same skill, Codex variant
139
- kapacitor-errors/
140
- SKILL.md
141
- kapacitor-validate-plan/
142
- SKILL.md
143
- kapacitor-disable/
135
+ disable/
144
136
  SKILL.md
145
- kapacitor-hide/
137
+ hide/
146
138
  SKILL.md
147
139
  ```
148
140
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: session-disable
2
+ name: disable
3
3
  description: >-
4
4
  This skill should be used when the user asks to "disable recording",
5
5
  "stop recording", "delete this session", "don't record this",
@@ -28,7 +28,7 @@ This will:
28
28
 
29
29
  ## Requirements
30
30
 
31
- - Must be run inside an active Claude Code session (`KAPACITOR_SESSION_ID` must be set)
31
+ - `kapacitor disable` resolves the current session id from the environment when the host agent CLI exposes one. If no session id is available, pass it explicitly: `kapacitor disable <sessionId>`.
32
32
  - The kapacitor CLI must be on PATH
33
33
 
34
34
  ## Notes
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: session-errors
2
+ name: errors
3
3
  description: >-
4
4
  This skill should be used when the user asks to "show errors", "extract errors",
5
5
  "what went wrong", "find tool errors", "review errors from session",
@@ -11,11 +11,11 @@ description: >-
11
11
 
12
12
  # Session Errors
13
13
 
14
- Extract tool call errors from a Claude Code session recorded by Kurrent Capacitor. The output lists each failed tool call — bash commands, file reads/writes, agent delegations, etc. — along with the error message and the tool that caused it.
14
+ Extract tool call errors from an agent session recorded by Kurrent Capacitor. The output lists each failed tool call — bash commands, file reads/writes, agent delegations, etc. — along with the error message and the tool that caused it.
15
15
 
16
16
  ## Usage
17
17
 
18
- Run `kapacitor errors` via the Bash tool. The session ID is automatically set by the `KAPACITOR_SESSION_ID` environment variable (persisted at session start).
18
+ Run `kapacitor errors` via the Bash tool. `kapacitor errors` resolves the current session id from the environment when the host agent CLI exposes one. If no session id is available, pass it explicitly: `kapacitor errors <sessionId>`.
19
19
 
20
20
  ```bash
21
21
  # Errors from the current session
@@ -47,7 +47,7 @@ When using `--chain`, errors from all sessions in the continuation chain are inc
47
47
 
48
48
  ## Practical Applications
49
49
 
50
- - **End-of-session review** — run after finishing a session to identify recurring mistakes and update CLAUDE.md with avoidance rules
50
+ - **End-of-session review** — run after finishing a session to identify recurring mistakes and add avoidance rules to the project's agent instructions file (e.g. `AGENTS.md`).
51
51
  - **Debugging** — quickly find what went wrong in a session without scrolling through the full timeline
52
52
  - **Pattern detection** — use `--chain` across a multi-session task to spot repeated error patterns (e.g., wrong file paths, incorrect API usage)
53
53
 
@@ -58,7 +58,7 @@ The `KAPACITOR_URL` environment variable overrides the default server URL (`http
58
58
  ## Tips
59
59
 
60
60
  - After extracting errors, look for patterns: the same tool failing repeatedly, or the same type of mistake across sessions.
61
- - Propose concrete avoidance rules based on the errors found — these can be added to the project's CLAUDE.md.
61
+ - Propose concrete avoidance rules based on the errors found — these can be added to the project's agent instructions file.
62
62
  - The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
63
63
 
64
64
  ## Error Handling
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: session-hide
2
+ name: hide
3
3
  description: >-
4
4
  This skill should be used when the user asks to "hide this session",
5
5
  "make this private", "hide session", "owner only", "make private",
@@ -24,7 +24,7 @@ This sets the session visibility to "none" (owner-only). Other users will no lon
24
24
 
25
25
  ## Requirements
26
26
 
27
- - Must be run inside an active Claude Code session (`KAPACITOR_SESSION_ID` must be set)
27
+ - `kapacitor hide` resolves the current session id from the environment when the host agent CLI exposes one. If no session id is available, pass it explicitly: `kapacitor hide <sessionId>`.
28
28
  - The kapacitor CLI must be on PATH
29
29
 
30
30
  ## Notes
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: session-recap
2
+ name: recap
3
3
  description: >-
4
4
  This skill should be used when the user asks to "read a previous session",
5
5
  "get session history", "recap session", "what happened in session X",
@@ -44,7 +44,7 @@ kapacitor recap --full <sessionId>
44
44
  kapacitor recap --chain <sessionId>
45
45
  ```
46
46
 
47
- The session ID is automatically set by the `KAPACITOR_SESSION_ID` environment variable (persisted at session start). You can pass an explicit ID to review a different session.
47
+ `kapacitor recap` resolves the current session id from the environment when the host agent CLI exposes one. If no session id is available, pass it explicitly: `kapacitor recap <sessionId>`.
48
48
 
49
49
  ## Repository Recap (`--repo`)
50
50
 
@@ -72,7 +72,7 @@ If no summary is available (e.g., active session), a hint is shown to use `--ful
72
72
  The complete transcript with these section types:
73
73
 
74
74
  - **`## User Prompt`** — what the user asked
75
- - **`## Assistant`** — Claude's text responses
75
+ - **`## Assistant`** — Agent text responses
76
76
  - **`## Plan`** — plans that were created
77
77
  - **`## Write <path>`** — files that were created (with syntax-highlighted content)
78
78
  - **`## Edit <path>`** — files that were edited (with diff content)
@@ -9,11 +9,11 @@ description: >-
9
9
 
10
10
  # Validate Plan
11
11
 
12
- Verify that all items in the current session's plan have been completed. Plans come from either a continuation (`SessionStarted.planContent`) or an in-session `ExitPlanMode` write to `~/.claude/plans/`.
12
+ Verify that all items in the current session's plan have been completed. Plans come from either a session continuation (`SessionStarted.planContent`) or an in-session plan recorded by the kapacitor hooks.
13
13
 
14
14
  ## Usage
15
15
 
16
- Run `kapacitor validate-plan` via the Bash tool. The session ID is automatically set by the `KAPACITOR_SESSION_ID` environment variable (persisted at session start).
16
+ Run `kapacitor validate-plan` via the Bash tool. `kapacitor validate-plan` resolves the current session id from the environment when the host agent CLI exposes one. If no session id is available, pass it explicitly: `kapacitor validate-plan <sessionId>`.
17
17
 
18
18
  ```bash
19
19
  # Validate the current session's plan
@@ -44,7 +44,7 @@ The command outputs three sections:
44
44
 
45
45
  If the output says "No plan found for this session", inform the user that no plan was detected for this session. A plan is only present when:
46
46
  - The session continued from a previous session that had a plan (`planContent`)
47
- - The session used `ExitPlanMode` to create a plan file (written to `~/.claude/plans/`)
47
+ - The session recorded an in-session plan via the kapacitor hooks.
48
48
 
49
49
  ## Environment
50
50
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kurrent/kapacitor",
3
- "version": "0.5.9",
3
+ "version": "0.5.11",
4
4
  "description": "CLI companion for Kurrent Capacitor — records and visualizes Claude Code sessions",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {
@@ -11,12 +11,12 @@
11
11
  "kapacitor": "bin/kapacitor.js"
12
12
  },
13
13
  "optionalDependencies": {
14
- "@kurrent/kapacitor-darwin-arm64": "0.5.9",
15
- "@kurrent/kapacitor-linux-x64": "0.5.9",
16
- "@kurrent/kapacitor-linux-arm64": "0.5.9",
17
- "@kurrent/kapacitor-linux-musl-x64": "0.5.9",
18
- "@kurrent/kapacitor-linux-musl-arm64": "0.5.9",
19
- "@kurrent/kapacitor-win-x64": "0.5.9"
14
+ "@kurrent/kapacitor-darwin-arm64": "0.5.11",
15
+ "@kurrent/kapacitor-linux-x64": "0.5.11",
16
+ "@kurrent/kapacitor-linux-arm64": "0.5.11",
17
+ "@kurrent/kapacitor-linux-musl-x64": "0.5.11",
18
+ "@kurrent/kapacitor-linux-musl-arm64": "0.5.11",
19
+ "@kurrent/kapacitor-win-x64": "0.5.11"
20
20
  },
21
21
  "files": [
22
22
  "bin/",
@@ -1,45 +0,0 @@
1
- ---
2
- name: kapacitor-disable
3
- description: >-
4
- This skill should be used when the user asks to "disable recording",
5
- "stop recording", "delete this session", "don't record this",
6
- "remove my session data", "erase this session", "turn off tracking",
7
- "stop tracking", "disable kapacitor", "remove session",
8
- or wants to stop the current session from being recorded.
9
- Stops the watcher, prevents future hooks, and deletes server data.
10
- ---
11
-
12
- # Kapacitor Disable
13
-
14
- Stop recording the current session and delete all data from the server.
15
-
16
- ## Usage
17
-
18
- ```bash
19
- # Active session — auto-resolved from CODEX_THREAD_ID (Codex 0.81+)
20
- kapacitor disable
21
-
22
- # Specific session by ID (from `kapacitor recap --repo`)
23
- kapacitor disable <sessionId>
24
- ```
25
-
26
- This will:
27
- 1. Stop the transcript watcher process
28
- 2. Prevent all future hook events from being sent for this session
29
- 3. Delete all session data from the server (event streams and read models)
30
-
31
- ## Requirements
32
-
33
- Run inside an active Codex CLI session (0.81+) — the active session is auto-resolved from `CODEX_THREAD_ID`. To act on a different session, pass its ID explicitly. Use `kapacitor recap --repo` to list recent session IDs in this repository.
34
-
35
- The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
36
-
37
- ## Notes
38
-
39
- - This action is irreversible — all session data will be permanently deleted from the server.
40
- - The local transcript file (Codex rollout `.jsonl`) is not affected — only server-side data is removed.
41
- - Subsequent hooks (session-end, etc.) will be silently skipped.
42
-
43
- ## Environment
44
-
45
- `KAPACITOR_URL` overrides the default server URL (`http://localhost:5108`).
@@ -1,70 +0,0 @@
1
- ---
2
- name: kapacitor-errors
3
- description: >-
4
- Use when the user asks to "show errors", "extract errors", "what went wrong",
5
- "find tool errors", "review errors from session", "check session errors",
6
- "list failures", "what failed in session X", "error report", "show mistakes",
7
- or wants to review tool call errors from a recorded session. Extracts tool
8
- errors via the `kapacitor errors` CLI.
9
- ---
10
-
11
- # Kapacitor Errors
12
-
13
- Extract tool call errors from a session recorded by Kurrent Capacitor. The output lists each failed tool call — shell commands, file reads/writes, agent delegations, etc. — along with the error message and the tool that caused it.
14
-
15
- Codex CLI 0.81+ exports `CODEX_THREAD_ID`; `kapacitor errors` uses it the same way it uses `KAPACITOR_SESSION_ID` for Claude. No args needed for the current session.
16
-
17
- ## Usage
18
-
19
- ```bash
20
- # Current session — auto-resolved from CODEX_THREAD_ID
21
- kapacitor errors
22
-
23
- # Errors from the full continuation chain of the current session
24
- kapacitor errors --chain
25
-
26
- # Errors from a specific session
27
- kapacitor errors <sessionId>
28
-
29
- # Errors from the full continuation chain starting at a session
30
- kapacitor errors --chain <sessionId>
31
- ```
32
-
33
- ## Output Format
34
-
35
- Each error is printed as a block with:
36
-
37
- - **Session ID** and optional **agent ID** (if the error occurred in a subagent).
38
- - **Event number** and **timestamp**.
39
- - **Tool name** — the tool that failed (e.g., Bash, Read, Edit, Write, Grep, Glob).
40
- - **Error message** — the error output or failure reason.
41
-
42
- When using `--chain`, errors from all sessions in the continuation chain are included, ordered chronologically.
43
-
44
- ## When to Use Each Flag
45
-
46
- - **No flag** (`kapacitor errors`) — reviewing errors from the current session.
47
- - **`<sessionId>`** — reviewing errors from a specific session (e.g. from `kapacitor recap --repo`).
48
- - **`--chain`** — reviewing errors across a full task that spanned multiple sessions.
49
-
50
- ## Practical Applications
51
-
52
- - **Post-mortem review** — after finishing a session, identify recurring mistakes and update project rules (CLAUDE.md / AGENTS.md) with avoidance guidance.
53
- - **Debugging** — quickly find what went wrong in a session without scrolling through the full timeline.
54
- - **Pattern detection** — use `--chain` across a multi-session task to spot repeated error patterns (e.g., wrong file paths, incorrect API usage).
55
-
56
- ## Environment
57
-
58
- `KAPACITOR_URL` overrides the default server URL (`http://localhost:5108`).
59
-
60
- ## Tips
61
-
62
- - After extracting errors, look for patterns: the same tool failing repeatedly, or the same type of mistake across sessions.
63
- - Propose concrete avoidance rules based on the errors found — these can be added to AGENTS.md / CLAUDE.md.
64
- - The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
65
-
66
- ## Error Handling
67
-
68
- - If the session is not found, the command prints an error and exits with code 1.
69
- - If no errors are found, the command prints "No errors found." — this is a good outcome.
70
- - If the Kurrent Capacitor server is unreachable, the command prints an HTTP error. Ensure the server is running.
@@ -1,41 +0,0 @@
1
- ---
2
- name: kapacitor-hide
3
- description: >-
4
- This skill should be used when the user asks to "hide this session",
5
- "make this private", "hide session", "owner only", "make private",
6
- "hide from others", "set private", "don't show this session",
7
- or wants to change the current session visibility to owner-only.
8
- Sets session visibility so only the owner can see it.
9
- ---
10
-
11
- # Kapacitor Hide
12
-
13
- Hide the current session so only you (the owner) can see it.
14
-
15
- ## Usage
16
-
17
- ```bash
18
- # Active session — auto-resolved from CODEX_THREAD_ID (Codex 0.81+)
19
- kapacitor hide
20
-
21
- # Specific session by ID (from `kapacitor recap --repo`)
22
- kapacitor hide <sessionId>
23
- ```
24
-
25
- This sets the session visibility to "none" (owner-only). Other users will no longer see this session in the Capacitor dashboard.
26
-
27
- ## Requirements
28
-
29
- Run inside an active Codex CLI session (0.81+) — the active session is auto-resolved from `CODEX_THREAD_ID`. To act on a different session, pass its ID explicitly. Use `kapacitor recap --repo` to list recent session IDs in this repository.
30
-
31
- The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
32
-
33
- ## Notes
34
-
35
- - This is reversible — visibility can be changed back via the Capacitor dashboard.
36
- - The session data remains on the server, just hidden from other users.
37
- - Unlike `kapacitor disable`, recording continues normally.
38
-
39
- ## Environment
40
-
41
- `KAPACITOR_URL` overrides the default server URL (`http://localhost:5108`).
@@ -1,95 +0,0 @@
1
- ---
2
- name: kapacitor-recap
3
- description: >-
4
- Use when the user asks to "read a previous session", "get session history",
5
- "recap session", "what happened in session X", "load context from a previous
6
- session", "continue from session", "what did we do last time", "catch me up",
7
- "summarize session", "what have we been working on", "recent changes",
8
- "recent sessions", or references prior work in this repo. Retrieves session
9
- summaries recorded by Kurrent Capacitor via the `kapacitor recap` CLI.
10
- ---
11
-
12
- # Kapacitor Recap
13
-
14
- Retrieve session history recorded by Kurrent Capacitor. Codex CLI 0.81+ exports `CODEX_THREAD_ID`; `kapacitor recap` uses it the same way it uses `KAPACITOR_SESSION_ID` for Claude. No args needed for the current session.
15
-
16
- ## Usage
17
-
18
- Run the `kapacitor recap` CLI via the shell. Do NOT call the HTTP API directly — the CLI handles formatting, error handling, and server URL resolution.
19
-
20
- ```bash
21
- # Current session — auto-resolved from CODEX_THREAD_ID
22
- kapacitor recap
23
-
24
- # Recent session summaries for the current repository (discovery)
25
- kapacitor recap --repo
26
-
27
- # A specific session by ID (from --repo output)
28
- kapacitor recap <sessionId>
29
-
30
- # Full transcript for a specific session
31
- kapacitor recap --full <sessionId>
32
-
33
- # Full continuation chain (all linked sessions, oldest first)
34
- kapacitor recap --chain <sessionId>
35
-
36
- # Both: full transcript across all chained sessions
37
- kapacitor recap --chain --full <sessionId>
38
- ```
39
-
40
- ## Default Output (Summary)
41
-
42
- Shows the plan (if any) and an AI-generated summary with:
43
- - **Context** — why the work was done.
44
- - **Key decisions** — trade-offs and design choices that matter for future work.
45
- - **Unfinished/Risks** — anything deferred or left incomplete.
46
-
47
- If no summary is available (e.g., active session), a hint is shown to use `--full`.
48
-
49
- ## Repository Recap (`--repo`)
50
-
51
- Returns AI-generated summaries from the most recent ended sessions in the current git repository. Each entry includes the session title, date, summary, and the session ID needed to drill in further.
52
-
53
- **Use this for discovery — not as the default entry point:**
54
- - The user says "what have we been working on recently?"
55
- - The user references prior work ("recently we implemented X")
56
- - You need context about other sessions in this repo, not the current one
57
-
58
- **Progressive disclosure:** Start with `kapacitor recap` (current session) for in-session work. Switch to `--repo` when you need cross-session context. Drill into a specific summary with `kapacitor recap --full <sessionId>`.
59
-
60
- ## Full Output (`--full`)
61
-
62
- The complete transcript with these section types:
63
-
64
- - **`## User Prompt`** — what the user asked.
65
- - **`## Assistant`** — text responses.
66
- - **`## Plan`** — plans that were created (Claude Code sessions only).
67
- - **`## Write <path>`** — files that were created (with syntax-highlighted content).
68
- - **`## Edit <path>`** — files that were edited (with diff content).
69
-
70
- When using `--chain`, sessions are separated by `# Session <id>` headers, and agent activity appears under `### Agent (<type>)` sub-headers.
71
-
72
- ## When to Use Each Flag
73
-
74
- - **No flag** (`kapacitor recap`) — quick context on the current session.
75
- - **`--repo`** — recent session summaries across the repo.
76
- - **`<sessionId>`** — quick context on a specific session (from `--repo` output).
77
- - **`--full <sessionId>`** — when you need exact prompts, responses, or file contents.
78
- - **`--chain <sessionId>`** — understanding the full history of a task that spanned multiple sessions.
79
- - **`--chain --full <sessionId>`** — complete transcript across all continuations.
80
-
81
- ## Environment
82
-
83
- `KAPACITOR_URL` overrides the default server URL (`http://localhost:5108`).
84
-
85
- ## Tips
86
-
87
- - Start with `kapacitor recap` (no args) for the active session, then `--repo` for cross-session discovery.
88
- - Summarize key decisions and changes for the user rather than echoing the full recap output verbatim.
89
- - The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
90
-
91
- ## Error Handling
92
-
93
- - If the session is not found, the command prints "Session not found" and exits with code 1.
94
- - If not in a git repository (for `--repo`), the command prints an error and exits with code 1.
95
- - If the Kurrent Capacitor server is unreachable, the command prints an HTTP error. Ensure the server is running.
@@ -1,53 +0,0 @@
1
- ---
2
- name: kapacitor-validate-plan
3
- description: >-
4
- This skill should be used when the user asks to "validate plan",
5
- "verify plan", "check plan completion", "did I finish everything",
6
- "is the plan done", "what's left to do", "validate my work",
7
- or wants to verify that all planned items were completed.
8
- ---
9
-
10
- # Kapacitor Validate Plan
11
-
12
- Verify that all items in the current session's plan have been completed.
13
-
14
- ## Usage
15
-
16
- ```bash
17
- # Active session — auto-resolved from CODEX_THREAD_ID (Codex 0.81+)
18
- kapacitor validate-plan
19
-
20
- # Specific session by ID (from `kapacitor recap --repo`)
21
- kapacitor validate-plan <sessionId>
22
- ```
23
-
24
- ## What It Returns
25
-
26
- The command outputs three sections:
27
-
28
- - **`## Plan`** — the full plan text.
29
- - **`## What's Done`** — two sub-sections:
30
- - **Summary** — AI-generated summary of what was accomplished (from `WhatsDoneGenerated` events, if available).
31
- - **Details** — list of files created (`Write`) and modified (`Edit`) during the session.
32
- - **`## Instructions`** — asks you to compare the plan against the summary and file list.
33
-
34
- ## What To Do With The Output
35
-
36
- 1. Read the plan carefully and identify each distinct planned item.
37
- 2. Compare each item against the summary and file list under "What's Done".
38
- 3. If all items are complete, confirm to the user that the plan is fully implemented.
39
- 4. If there are gaps, list the missing items and complete them now.
40
-
41
- ## When No Plan Is Found
42
-
43
- If the output says "No plan found for this session", inform the user that no plan was detected for this session. Plans are recorded when a session emits an `ExitPlanMode`-style event; not every session has one.
44
-
45
- ## Requirements
46
-
47
- Run inside an active Codex CLI session (0.81+) — the active session is auto-resolved from `CODEX_THREAD_ID`. To act on a different session, pass its ID explicitly.
48
-
49
- The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
50
-
51
- ## Environment
52
-
53
- `KAPACITOR_URL` overrides the default server URL (`http://localhost:5108`).