@kurrent/kapacitor 0.5.9 → 0.5.10
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.
- package/kapacitor/.claude-plugin/plugin.json +1 -1
- package/kapacitor/.codex-plugin/plugin.json +0 -1
- package/kapacitor/README.md +18 -26
- package/kapacitor/skills/{session-disable → disable}/SKILL.md +2 -2
- package/kapacitor/skills/{session-errors → errors}/SKILL.md +5 -5
- package/kapacitor/skills/{session-hide → hide}/SKILL.md +2 -2
- package/kapacitor/skills/{session-recap → recap}/SKILL.md +3 -3
- package/kapacitor/skills/validate-plan/SKILL.md +3 -3
- package/package.json +7 -7
- package/kapacitor/codex-skills/kapacitor-disable/SKILL.md +0 -45
- package/kapacitor/codex-skills/kapacitor-errors/SKILL.md +0 -70
- package/kapacitor/codex-skills/kapacitor-hide/SKILL.md +0 -41
- package/kapacitor/codex-skills/kapacitor-recap/SKILL.md +0 -95
- package/kapacitor/codex-skills/kapacitor-validate-plan/SKILL.md +0 -53
package/kapacitor/README.md
CHANGED
|
@@ -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.
|
|
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:
|
|
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 --
|
|
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
|
|
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
|
-
|
|
127
|
-
SKILL.md — /kapacitor:
|
|
128
|
-
|
|
129
|
+
recap/
|
|
130
|
+
SKILL.md — /kapacitor:recap skill (Claude)
|
|
131
|
+
errors/
|
|
129
132
|
SKILL.md
|
|
130
133
|
validate-plan/
|
|
131
134
|
SKILL.md
|
|
132
|
-
|
|
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
|
-
|
|
137
|
+
hide/
|
|
146
138
|
SKILL.md
|
|
147
139
|
```
|
|
148
140
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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
|
-
-
|
|
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:
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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:
|
|
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
|
-
-
|
|
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:
|
|
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
|
-
|
|
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`** —
|
|
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
|
|
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.
|
|
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
|
|
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.
|
|
3
|
+
"version": "0.5.10",
|
|
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.
|
|
15
|
-
"@kurrent/kapacitor-linux-x64": "0.5.
|
|
16
|
-
"@kurrent/kapacitor-linux-arm64": "0.5.
|
|
17
|
-
"@kurrent/kapacitor-linux-musl-x64": "0.5.
|
|
18
|
-
"@kurrent/kapacitor-linux-musl-arm64": "0.5.
|
|
19
|
-
"@kurrent/kapacitor-win-x64": "0.5.
|
|
14
|
+
"@kurrent/kapacitor-darwin-arm64": "0.5.10",
|
|
15
|
+
"@kurrent/kapacitor-linux-x64": "0.5.10",
|
|
16
|
+
"@kurrent/kapacitor-linux-arm64": "0.5.10",
|
|
17
|
+
"@kurrent/kapacitor-linux-musl-x64": "0.5.10",
|
|
18
|
+
"@kurrent/kapacitor-linux-musl-arm64": "0.5.10",
|
|
19
|
+
"@kurrent/kapacitor-win-x64": "0.5.10"
|
|
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`).
|