happenin 0.3.0 → 0.5.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+	"name": "happenin",
+	"description": "Record Cursor and Claude Code agent events in a local dashboard.",
+	"owner": {
+		"name": "Yogev Boaron Ben-Har"
+	},
+	"plugins": [
+		{
+			"name": "happenin",
+			"source": "./plugins/claude",
+			"description": "Record local Claude Code events for the happenin dashboard."
+		}
+	]
+}

package/.cursor-plugin/marketplace.json

@@ -0,0 +1,11 @@
+{
+	"name": "happenin",
+	"owner": { "name": "Yogev Boaron Ben-Har" },
+	"plugins": [
+		{
+			"name": "happenin",
+			"source": "./plugins/cursor",
+			"description": "Record local Cursor agent events for the happenin dashboard."
+		}
+	]
+}

package/README.md

@@ -5,19 +5,19 @@
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v3.0%20adopted-ff69b4.svg)](docs/CODE_OF_CONDUCT.md)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
 
-A macOS CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.
+A CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.
 
 ![happenin dashboard](docs/dashboard.gif)
 
 ## Try it
 
 ```bash
-npx -y happenin install   # add record hooks to Cursor and Claude Code
+npx -y happenin install   # show plugin setup for Cursor and Claude Code
 npx -y happenin import    # import existing transcripts
 npx -y happenin dashboard # open the live dashboard
 ```
 
-No global install needed: hooks installed this way run through `npx`. For a permanent setup, use the [global install](#install).
+No global install needed: the packaged hooks run through `npx`. For a permanent setup, use the [global install](#install).
 
 ## Why
 
@@ -29,7 +29,7 @@ Cursor and Claude Code can emit local hooks for each session, tool use, prompt,
 
 ## Requirements
 
-- macOS
+- macOS, Linux, or Windows
 - Node.js `>= 22.13.0` (uses the built-in `node:sqlite` module, available since Node 22.13)
 - Zero runtime dependencies
 - The dashboard loads htmx and htmx-ext-sse from a CDN
@@ -52,7 +52,7 @@ npm run build
 ## Quick start
 
 ```bash
-# Install hooks into Cursor and Claude Code (backs up existing configs)
+# Show the plugin setup for Cursor and Claude Code
 happenin install
 
 # Import existing transcripts
@@ -68,7 +68,9 @@ The dashboard opens at `http://localhost:8765`. New events appear automatically.
 
 ### `happenin install [--cursor] [--claude]`
 
-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.
+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.
+
+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.
 
 ```bash
 happenin install --cursor
@@ -142,6 +144,13 @@ Clicking a tool, skill, or file jumps to a list of every session that used it. T
 chart can be scoped to one directory with the "md files directory" filter (the common path prefix
 is stripped from the dropdown labels, and paths under `/private` are excluded).
 
+The persistent filter bar also has multi-select "directories", "skills", and "integrations (MCP)"
+controls. Each lets you pick several values at once — matching sessions with _any_ of the selected
+values in that category (OR) — and the categories combine with every other filter, including each
+other, with AND (e.g. directory X or Y, AND skill A or B). The "integrations (MCP)" list is derived
+from the data itself: it parses the `mcp__<server>__<tool>` naming convention on recorded tool
+calls and lists every distinct MCP server actually seen, with no hardcoded set of servers.
+
 A context breakdown widget splits recorded payload size (and, for imported Claude sessions, token
 usage) into four buckets: MCP server calls, markdown file reads, bloatware (skill loads and
 lifecycle/hook noise), and actual value (real tool calls and conversation turns). It appears on the
@@ -180,18 +189,22 @@ npm install
 npm run build
 ```
 
+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.
+
 Before opening a pull request, run the full check suite:
 
 ```bash
-npm run build
-npm run typecheck
-npm run format
-npm run lint
-npm run duplicates:ci
-npm run knip:ci
-npm run test:ci
+nub run build
+nub run typecheck
+nub run format
+nub run lint
+nub run duplicates:ci
+nub run knip:ci
+nub run test:ci
 ```
 
+The same scripts also work with `npm run <script>`.
+
 See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for details.
 
 ## Documentation

package/assets/help.md

@@ -1,20 +1,16 @@
 # happenin
 
-A macOS CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.
+A CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.
 
 ## Commands
 
 ### `happenin install [--cursor] [--claude]`
 
-Backs up and appends `happenin record` hooks to your Cursor and Claude Code configuration files.
-Re-running install replaces previous happenin hooks instead of duplicating them. When happenin
-runs through npx, hooks are written as `npx -y happenin` commands so they keep working without a
-global install.
+Shows how to install the packaged Cursor and Claude Code plugins without changing user config files.
+The plugin hooks use `npx -y happenin`, so they work with the trial and global-install flows.
 
-- `--cursor` — install Cursor hooks only.
-- `--claude` — install Claude Code hooks only.
-
-By default both are installed. Backups are written to `~/.happenin/backups/`.
+- `--cursor` — show Cursor setup only.
+- `--claude` — show Claude Code setup only.
 
 ### `happenin record <source> [event]`