@kurrent/kapacitor 0.5.5 → 0.5.6

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.
Files changed (7) hide show
  1. package/kapacitor/.claude-plugin/plugin.json +1 -1
  2. package/kapacitor/codex-skills/kapacitor-disable/SKILL.md +45 -0
  3. package/kapacitor/codex-skills/kapacitor-errors/SKILL.md +15 -8
  4. package/kapacitor/codex-skills/kapacitor-hide/SKILL.md +41 -0
  5. package/kapacitor/codex-skills/kapacitor-recap/SKILL.md +30 -27
  6. package/kapacitor/codex-skills/kapacitor-validate-plan/SKILL.md +53 -0
  7. package/package.json +7 -7
package/kapacitor/.claude-plugin/plugin.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "kapacitor",
3
- "version": "0.5.5",
3
+ "version": "0.5.6",
4
4
  "description": "Records and visualizes Claude Code sessions via kapacitor CLI hooks"
5
5
  }
package/kapacitor/codex-skills/kapacitor-disable/SKILL.md ADDED
@@ -0,0 +1,45 @@
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`).
package/kapacitor/codex-skills/kapacitor-errors/SKILL.md CHANGED
@@ -12,11 +12,17 @@ description: >-
12
12
 
13
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
14
 
15
- ## Usage
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
16
 
17
- Codex sessions do not export `KAPACITOR_SESSION_ID`, so you must pass the session ID explicitly. To find recent session IDs, run `kapacitor recap --repo` first.
17
+ ## Usage
18
18
 
19
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
+
20
26
  # Errors from a specific session
21
27
  kapacitor errors <sessionId>
22
28
 
@@ -28,17 +34,18 @@ kapacitor errors --chain <sessionId>
28
34
 
29
35
  Each error is printed as a block with:
30
36
 
31
- - **Session ID** and optional **agent ID** (if the error occurred in a subagent)
32
- - **Event number** and **timestamp**
33
- - **Tool name** — the tool that failed (e.g., Bash, Read, Edit, Write, Grep, Glob)
34
- - **Error message** — the error output or failure reason
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.
35
41
 
36
42
  When using `--chain`, errors from all sessions in the continuation chain are included, ordered chronologically.
37
43
 
38
44
  ## When to Use Each Flag
39
45
 
40
- - **No flag** (`kapacitor errors <sessionId>`) — reviewing errors from one specific session
41
- - **`--chain <sessionId>`** — reviewing errors across a full task that spanned multiple sessions
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.
42
49
 
43
50
  ## Practical Applications
44
51
 
package/kapacitor/codex-skills/kapacitor-hide/SKILL.md ADDED
@@ -0,0 +1,41 @@
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`).
package/kapacitor/codex-skills/kapacitor-recap/SKILL.md CHANGED
@@ -11,17 +11,20 @@ description: >-
11
11
 
12
12
  # Kapacitor Recap
13
13
 
14
- Retrieve session history recorded by Kurrent Capacitor. Inside Codex, the recommended entry point is the **repository recap** — Codex sessions do not export a `KAPACITOR_SESSION_ID` environment variable, so the "current session" shortcut is unavailable. Drill into a specific session by passing its ID explicitly.
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
15
 
16
16
  ## Usage
17
17
 
18
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
19
 
20
20
  ```bash
21
- # Recent session summaries for the current repository (start here)
21
+ # Current session — auto-resolved from CODEX_THREAD_ID
22
+ kapacitor recap
23
+
24
+ # Recent session summaries for the current repository (discovery)
22
25
  kapacitor recap --repo
23
26
 
24
- # Drill into a specific session by ID (from --repo output)
27
+ # A specific session by ID (from --repo output)
25
28
  kapacitor recap <sessionId>
26
29
 
27
30
  # Full transcript for a specific session
@@ -34,46 +37,46 @@ kapacitor recap --chain <sessionId>
34
37
  kapacitor recap --chain --full <sessionId>
35
38
  ```
36
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
+
37
49
  ## Repository Recap (`--repo`)
38
50
 
39
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.
40
52
 
41
- **Use this when:**
53
+ **Use this for discovery — not as the default entry point:**
42
54
  - The user says "what have we been working on recently?"
43
55
  - The user references prior work ("recently we implemented X")
44
- - You need context about recent changes in this repo
45
- - Starting a new session and want to understand recent activity
56
+ - You need context about other sessions in this repo, not the current one
46
57
 
47
- **Progressive disclosure:** Start with `--repo` for the overview. If a specific session's summary is relevant, drill into it with `kapacitor recap --full <sessionId>` to get the complete transcript. This avoids loading full transcripts for all sessions into context.
48
-
49
- ## Session Recap (`<sessionId>`)
50
-
51
- Shows the plan (if any) and an AI-generated summary with:
52
- - **Context** — why the work was done
53
- - **Key decisions** — trade-offs and design choices that matter for future work
54
- - **Unfinished/Risks** — anything deferred or left incomplete
55
-
56
- If no summary is available (e.g., active session), a hint is shown to use `--full`.
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>`.
57
59
 
58
60
  ## Full Output (`--full`)
59
61
 
60
62
  The complete transcript with these section types:
61
63
 
62
- - **`## User Prompt`** — what the user asked
63
- - **`## Assistant`** — text responses
64
- - **`## Plan`** — plans that were created (Claude Code sessions only)
65
- - **`## Write <path>`** — files that were created (with syntax-highlighted content)
66
- - **`## Edit <path>`** — files that were edited (with diff content)
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).
67
69
 
68
70
  When using `--chain`, sessions are separated by `# Session <id>` headers, and agent activity appears under `### Agent (<type>)` sub-headers.
69
71
 
70
72
  ## When to Use Each Flag
71
73
 
72
- - **`--repo`** — recent session summaries across the repo (start here)
73
- - **`<sessionId>`** — quick context on a specific session (from `--repo` output)
74
- - **`--full <sessionId>`** — when you need exact prompts, responses, or file contents
75
- - **`--chain <sessionId>`** — understanding the full history of a task that spanned multiple sessions
76
- - **`--chain --full <sessionId>`** — complete transcript across all continuations
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.
77
80
 
78
81
  ## Environment
79
82
 
@@ -81,7 +84,7 @@ When using `--chain`, sessions are separated by `# Session <id>` headers, and ag
81
84
 
82
85
  ## Tips
83
86
 
84
- - Always start with `--repo` — it gives the overview without flooding context.
87
+ - Start with `kapacitor recap` (no args) for the active session, then `--repo` for cross-session discovery.
85
88
  - Summarize key decisions and changes for the user rather than echoing the full recap output verbatim.
86
89
  - The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
87
90
 
package/kapacitor/codex-skills/kapacitor-validate-plan/SKILL.md ADDED
@@ -0,0 +1,53 @@
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`).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kurrent/kapacitor",
3
- "version": "0.5.5",
3
+ "version": "0.5.6",
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.5",
15
- "@kurrent/kapacitor-linux-x64": "0.5.5",
16
- "@kurrent/kapacitor-linux-arm64": "0.5.5",
17
- "@kurrent/kapacitor-linux-musl-x64": "0.5.5",
18
- "@kurrent/kapacitor-linux-musl-arm64": "0.5.5",
19
- "@kurrent/kapacitor-win-x64": "0.5.5"
14
+ "@kurrent/kapacitor-darwin-arm64": "0.5.6",
15
+ "@kurrent/kapacitor-linux-x64": "0.5.6",
16
+ "@kurrent/kapacitor-linux-arm64": "0.5.6",
17
+ "@kurrent/kapacitor-linux-musl-x64": "0.5.6",
18
+ "@kurrent/kapacitor-linux-musl-arm64": "0.5.6",
19
+ "@kurrent/kapacitor-win-x64": "0.5.6"
20
20
  },
21
21
  "files": [
22
22
  "bin/",