@kurrent/kapacitor 0.1.3 → 0.1.5

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 (3) hide show
  1. package/package.json +8 -8
  2. package/plugin/.claude-plugin/plugin.json +1 -1
  3. package/plugin/skills/session-recap/SKILL.md +46 -8
package/package.json CHANGED
@@ -1,19 +1,19 @@
1
1
  {
2
2
  "name": "@kurrent/kapacitor",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
4
4
  "description": "CLI companion for Kurrent Capacitor — records and visualizes Claude Code sessions",
5
5
  "license": "UNLICENSED",
6
6
  "bin": {
7
7
  "kapacitor": "bin/kapacitor.js"
8
8
  },
9
9
  "optionalDependencies": {
10
- "@kurrent/kapacitor-darwin-arm64": "0.1.3",
11
- "@kurrent/kapacitor-darwin-x64": "0.1.3",
12
- "@kurrent/kapacitor-linux-x64": "0.1.3",
13
- "@kurrent/kapacitor-linux-arm64": "0.1.3",
14
- "@kurrent/kapacitor-linux-musl-x64": "0.1.3",
15
- "@kurrent/kapacitor-linux-musl-arm64": "0.1.3",
16
- "@kurrent/kapacitor-win-x64": "0.1.3"
10
+ "@kurrent/kapacitor-darwin-arm64": "0.1.5",
11
+ "@kurrent/kapacitor-darwin-x64": "0.1.5",
12
+ "@kurrent/kapacitor-linux-x64": "0.1.5",
13
+ "@kurrent/kapacitor-linux-arm64": "0.1.5",
14
+ "@kurrent/kapacitor-linux-musl-x64": "0.1.5",
15
+ "@kurrent/kapacitor-linux-musl-arm64": "0.1.5",
16
+ "@kurrent/kapacitor-win-x64": "0.1.5"
17
17
  },
18
18
  "files": [
19
19
  "bin/",
package/plugin/.claude-plugin/plugin.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "kapacitor",
3
- "version": "1.5.0",
3
+ "version": "0.1.5",
4
4
  "description": "Records and visualizes Claude Code sessions via kapacitor CLI hooks"
5
5
  }
package/plugin/skills/session-recap/SKILL.md CHANGED
@@ -6,35 +6,68 @@ description: >-
6
6
  "load context from a previous session", "continue from session",
7
7
  "what did we do last time", "catch me up on session X",
8
8
  "summarize session", "show me what happened",
9
+ "what have we been working on", "recently we implemented",
10
+ "what was done in this repo", "recent changes", "recent sessions",
9
11
  or provides a session ID they want to review.
10
12
  Provides instructions for retrieving session history via the kapacitor CLI.
11
13
  ---
12
14
 
13
15
  # Session Recap
14
16
 
15
- Retrieve the history of a Claude Code session recorded by Kurrent Capacitor. The recap contains user prompts, assistant responses, plans, and file writes/edits — everything needed to understand what happened in a session or to continue where it left off.
17
+ Retrieve session history recorded by Kurrent Capacitor. Supports single-session recap, continuation chains, and **repository-wide session summaries** for understanding recent work across multiple sessions.
16
18
 
17
19
  ## Usage
18
20
 
19
21
  **IMPORTANT:** Always use the `kapacitor recap` CLI command. Do NOT call the HTTP API directly via `curl`, `WebFetch`, or `HttpClient` — the CLI handles formatting, error handling, and server URL resolution.
20
22
 
21
23
  ```bash
22
- # Current session recap
24
+ # Current session summary (default — concise AI-generated overview)
23
25
  kapacitor recap
24
26
 
27
+ # Full transcript (all prompts, responses, file changes)
28
+ kapacitor recap --full
29
+
25
30
  # Full continuation chain (all linked sessions, oldest first)
26
31
  kapacitor recap --chain
27
32
 
33
+ # Both: full transcript across all chained sessions
34
+ kapacitor recap --chain --full
35
+
36
+ # Recent session summaries for the current repository
37
+ kapacitor recap --repo
38
+
28
39
  # Explicit session ID (overrides env var)
29
40
  kapacitor recap <sessionId>
41
+ kapacitor recap --full <sessionId>
30
42
  kapacitor recap --chain <sessionId>
31
43
  ```
32
44
 
33
45
  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.
34
46
 
35
- ## Output Format
47
+ ## Repository Recap (`--repo`)
48
+
49
+ Returns AI-generated summaries from the most recent ended sessions in the current git repository. Each entry includes the session title, date, summary, and a command to get the full transcript.
50
+
51
+ **Use this when:**
52
+ - The user says "what have we been working on recently?"
53
+ - The user references prior work ("recently we implemented X")
54
+ - You need context about recent changes in this repo
55
+ - Starting a new session and want to understand recent activity
56
+
57
+ **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.
58
+
59
+ ## Default Output (Summary)
60
+
61
+ Shows the plan (if any) and an AI-generated summary with:
62
+ - **Context** — why the work was done
63
+ - **Key decisions** — trade-offs and design choices that matter for future work
64
+ - **Unfinished/Risks** — anything deferred or left incomplete
65
+
66
+ If no summary is available (e.g., active session), a hint is shown to use `--full`.
67
+
68
+ ## Full Output (`--full`)
36
69
 
37
- The command outputs markdown with these section types:
70
+ The complete transcript with these section types:
38
71
 
39
72
  - **`## User Prompt`** — what the user asked
40
73
  - **`## Assistant`** — Claude's text responses
@@ -46,8 +79,11 @@ When using `--chain`, sessions are separated by `# Session <id>` headers, and ag
46
79
 
47
80
  ## When to Use Each Flag
48
81
 
49
- - **No flag** (`kapacitor recap`) — reviewing the current session
50
- - **`--chain`** (`kapacitor recap --chain`) — understanding the full history of a task that spanned multiple sessions, or resuming work that was continued across sessions
82
+ - **`--repo`** (`kapacitor recap --repo`) — recent session summaries across the repo (start here for "what did we do recently?")
83
+ - **No flags** (`kapacitor recap`) — quick context on the current session
84
+ - **`--full`** (`kapacitor recap --full`) — when you need exact prompts, responses, or file contents from a specific session
85
+ - **`--chain`** (`kapacitor recap --chain`) — understanding the full history of a task that spanned multiple sessions
86
+ - **`--chain --full`** — complete transcript across all continuations
51
87
 
52
88
  ## Environment
53
89
 
@@ -55,12 +91,14 @@ The `KAPACITOR_URL` environment variable overrides the default server URL (`http
55
91
 
56
92
  ## Tips
57
93
 
58
- - The output can be large for long sessions. Scan for `## User Prompt` headers to quickly locate specific interactions.
59
- - When continuing work from a previous session, use `--chain` to get the full context across continuations.
94
+ - **For "what have we been working on?"** — use `--repo` first, then drill into specific sessions.
95
+ - Start with the default summary. Only use `--full` when you need specific details.
96
+ - When continuing work from a previous session, use `--chain` to get summaries across continuations.
60
97
  - Summarize key decisions and changes for the user rather than echoing the full recap output verbatim.
61
98
  - The `kapacitor` CLI must be available on PATH (typically installed at `~/.local/bin/kapacitor`).
62
99
 
63
100
  ## Error Handling
64
101
 
65
102
  - If the session is not found, the command prints "Session not found" and exits with code 1.
103
+ - If not in a git repository (for `--repo`), the command prints an error and exits with code 1.
66
104
  - If the Kurrent Capacitor server is unreachable, the command prints an HTTP error. Ensure the server is running.