happenin 0.4.0 → 0.6.0

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.
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "happenin",
3
+ "description": "Record Cursor and Claude Code agent events in a local dashboard.",
4
+ "owner": {
5
+ "name": "Yogev Boaron Ben-Har"
6
+ },
7
+ "plugins": [
8
+ {
9
+ "name": "happenin",
10
+ "source": "./plugins/claude",
11
+ "description": "Record local Claude Code events for the happenin dashboard."
12
+ }
13
+ ]
14
+ }
@@ -0,0 +1,27 @@
1
+ {
2
+ "name": "happenin",
3
+ "description": "Record Cursor and Claude Code agent events in a local dashboard.",
4
+ "version": "0.6.0",
5
+ "author": {
6
+ "name": "Yogev Boaron Ben-Har"
7
+ },
8
+ "homepage": "https://github.com/YogliB/happenin",
9
+ "keywords": ["hooks", "observability", "sessions", "analytics"],
10
+ "owner": {
11
+ "name": "Yogev Boaron Ben-Har"
12
+ },
13
+ "plugins": [
14
+ {
15
+ "name": "happenin",
16
+ "source": "./plugins/cursor",
17
+ "description": "Record local Cursor agent events for the happenin dashboard.",
18
+ "version": "0.6.0",
19
+ "author": {
20
+ "name": "Yogev Boaron Ben-Har"
21
+ },
22
+ "license": "MIT",
23
+ "keywords": ["hooks", "observability", "sessions"],
24
+ "category": "analytics"
25
+ }
26
+ ]
27
+ }
package/README.md CHANGED
@@ -12,12 +12,12 @@ A CLI that records Cursor and Claude Code agent events to a local SQLite databas
12
12
  ## Try it
13
13
 
14
14
  ```bash
15
- npx -y happenin install # add record hooks to Cursor and Claude Code
15
+ npx -y happenin install # show plugin setup for Cursor and Claude Code
16
16
  npx -y happenin import # import existing transcripts
17
17
  npx -y happenin dashboard # open the live dashboard
18
18
  ```
19
19
 
20
- No global install needed: hooks installed this way run through `npx`. For a permanent setup, use the [global install](#install).
20
+ No global install needed: the packaged hooks run through `npx`. For a permanent setup, use the [global install](#install).
21
21
 
22
22
  ## Why
23
23
 
@@ -52,7 +52,7 @@ npm run build
52
52
  ## Quick start
53
53
 
54
54
  ```bash
55
- # Install hooks into Cursor and Claude Code (backs up existing configs)
55
+ # Show the plugin setup for Cursor and Claude Code
56
56
  happenin install
57
57
 
58
58
  # Import existing transcripts
@@ -68,7 +68,9 @@ The dashboard opens at `http://localhost:8765`. New events appear automatically.
68
68
 
69
69
  ### `happenin install [--cursor] [--claude]`
70
70
 
71
- Backs up and appends `happenin record` hooks to `~/.cursor/hooks.json` and `~/.claude/settings.json`. Backups are written to `~/.happenin/backups/`. Re-running `install` replaces the previous `happenin` hooks instead of duplicating them, and hooks installed through `npx -y happenin install` are written as `npx -y happenin` commands so they keep working without a global install.
71
+ Prints the supported plugin setup for Cursor and Claude Code. The packaged plugins call `npx -y happenin record`, so they work with both the trial and global-install flows without rewriting `~/.cursor/hooks.json` or `~/.claude/settings.json`. Use `--cursor` or `--claude` to show one client only.
72
+
73
+ Migrating from a pre-plugin install? Remove the old `happenin record` entries from `~/.cursor/hooks.json` and `~/.claude/settings.json` by hand (one-time step). Keep every unrelated hook.
72
74
 
73
75
  ```bash
74
76
  happenin install --cursor
@@ -187,18 +189,22 @@ npm install
187
189
  npm run build
188
190
  ```
189
191
 
192
+ Every pull request must reference an existing issue. If no issue exists, open one first, then link it in the pull request body with `Closes #<issue>`. CI enforces this on every pull request; bot PRs are skipped, and maintainers can bypass with the `no-issue` label.
193
+
190
194
  Before opening a pull request, run the full check suite:
191
195
 
192
196
  ```bash
193
- npm run build
194
- npm run typecheck
195
- npm run format
196
- npm run lint
197
- npm run duplicates:ci
198
- npm run knip:ci
199
- npm run test:ci
197
+ nub run build
198
+ nub run typecheck
199
+ nub run format
200
+ nub run lint
201
+ nub run duplicates:ci
202
+ nub run knip:ci
203
+ nub run test:ci
200
204
  ```
201
205
 
206
+ The same scripts also work with `npm run <script>`.
207
+
202
208
  See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for details.
203
209
 
204
210
  ## Documentation
@@ -224,7 +230,7 @@ See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for details.
224
230
 
225
231
  ## Agent skill
226
232
 
227
- Install the reusable `happenin` skill for agents that support `SKILL.md` files:
233
+ The Cursor and Claude Code plugins bundle the reusable `happenin` skill, so installing the plugin installs the skill too. For other agents that support `SKILL.md` files, install it directly:
228
234
 
229
235
  ```bash
230
236
  npx skills add YogliB/happenin --skill happenin
package/assets/help.md CHANGED
@@ -6,15 +6,11 @@ A CLI that records Cursor and Claude Code agent events to a local SQLite databas
6
6
 
7
7
  ### `happenin install [--cursor] [--claude]`
8
8
 
9
- Backs up and appends `happenin record` hooks to your Cursor and Claude Code configuration files.
10
- Re-running install replaces previous happenin hooks instead of duplicating them. When happenin
11
- runs through npx, hooks are written as `npx -y happenin` commands so they keep working without a
12
- global install.
9
+ Shows how to install the packaged Cursor and Claude Code plugins without changing user config files.
10
+ The plugin hooks use `npx -y happenin`, so they work with the trial and global-install flows.
13
11
 
14
- - `--cursor` — install Cursor hooks only.
15
- - `--claude` — install Claude Code hooks only.
16
-
17
- By default both are installed. Backups are written to `~/.happenin/backups/`.
12
+ - `--cursor` — show Cursor setup only.
13
+ - `--claude` — show Claude Code setup only.
18
14
 
19
15
  ### `happenin record <source> [event]`
20
16