happeninlisted
Install: claude install-skill YogliB/happenin
# Using happenin
`happenin` is a local CLI that captures Cursor and Claude Code hook events into a SQLite database and serves a real-time dashboard. All data stays on the user's machine.
This is a cross-agent skill. Any agent that supports `SKILL.md` files can load it.
## Install
If `happenin` is not installed, install the CLI first:
```bash
npm install -g happenin
```
Or run from source:
```bash
nub install
nub run build
```
The Cursor and Claude Code plugins bundle this skill, so installing the plugin is enough for those clients. For any other agent, add it from the repository:
```bash
npx skills add YogliB/happenin --skill happenin
```
For a global install, add the `-g` flag. You can also copy `skills/happenin/SKILL.md` from this repository into your agent's skills directory.
## `happenin install [--cursor] [--claude]`
Shows the supported plugin setup for Cursor and Claude Code. The packaged hooks use `npx -y happenin record`, so the normal setup does not edit user configuration. 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.
## `happenin record <source> [event]`
The hook target. It reads a JSON payload from stdin, writes it to `~/.happenin/happenin.db`, and prints the required response the agent expects.
- `<source>` — `cursor` or `claude`.
- `[event]` — only requi