@mattersec/matt
v0.1.42
Published
matt — AI agent telemetry for developer machines
Readme
@mattersec/matt
AI agent telemetry collector for developer machines. Monitors Claude Code, Cursor, and Codex hooks, captures events, forwards to the Mattersec security intelligence dashboard.
Install
npm install -g @mattersec/mattInstallation notes
On POSIX platforms the postinstall step replaces the JS shim with a direct symlink to the native binary so matt invocations skip Node cold-start entirely. If you install with npm install -g --ignore-scripts (common in locked-down corporate npm environments), the optimize step is skipped and every invocation pays ~30 ms of Node startup overhead. Functionally correct, just slower. To apply the optimization after an --ignore-scripts install:
node "$(npm root -g)/@mattersec/matt/install.js"Quickstart
Easiest path: visit app.mattersec.com, sign up, and follow the install wizard. It hands you a one-time npx @mattersec/matt link --token=… command that authenticates this machine, installs your AI tool hooks, and starts the daemon — all in one paste.
If you'd rather drive each step manually:
matt auth login # device-code flow
matt install-hooks claude-code # install hooks
matt start # register background service + start daemon
matt statusUninstall
Because npm has no preuninstall hook, run the service cleanup explicitly before removing the package:
matt uninstall-service
npm uninstall -g @mattersec/mattCommands
| Command | Purpose |
|---|---|
| matt start | Register service + start daemon |
| matt stop | Stop daemon (service registration stays) |
| matt status | Print daemon / auth / events status |
| matt auth login/logout/status/whoami | Auth subcommands |
| matt install-hooks <tool> | Install hooks for claude-code, cursor, or codex |
| matt uninstall-hooks <tool> | Remove hooks |
| matt check | Hook installation status |
| matt buffer list/flush/clear | Manage the encrypted event buffer |
| matt dashboard | Open Mattersec dashboard in browser |
| matt update | Update via npm registry |
| matt uninstall-service | Remove service registration |
License
Proprietary — © Mattersec Labs.
