session-intelligence-cli
v0.3.0
Published
Real-time dashboard for AI coding sessions — track activity, git changes, token usage, and session history across Claude Code and Cursor
Downloads
92
Maintainers
Readme
Session Intelligence CLI
A plugin for Claude Code and Cursor that gives you a real-time dashboard for all your AI coding sessions.
See what every session is doing, track token usage and git changes, and get a full activity history across all your projects.
What it does
- Live session tracking — see every session as it thinks, runs tools, or waits for input
- Activity heatmap & stats — tokens, lines changed, model usage, and streaks over time
- GitHub integration — auto-links sessions to PRs, tracks open issues and review requests
- Multi-project — one dashboard for all your repos and branches
Quick start
Claude Code
npx session-intelligence-cli setup --tool claude-codeThis will:
- Ask for your server URL and API key (get one at session-intelligence.com)
- Save config to
~/.session-intelligence/config.json - Register hooks in
~/.claude/settings.json
Your next Claude Code session will start reporting automatically.
Cursor
npx session-intelligence-cli setup --tool cursorThis will:
- Ask for your server URL and API key
- Save config to
~/.session-intelligence/config.json - Register hooks in
~/.cursor/hooks.json
Your next Cursor session will start reporting automatically.
How it works
The CLI registers lightweight hooks that fire on session lifecycle events:
| Event | Claude Code | Cursor | What it reports |
|---|---|---|---|
| SessionStart | ✓ | ✓ | New session created |
| PostToolUse | ✓ | ✓ | Tool activity (Read, Edit, Bash, etc.) |
| UserPromptSubmit | — | ✓ | User prompt submitted |
| Notification | ✓ | — | Permission requests / input needed |
| SubagentStop | ✓ | ✓ | Subagent task completion |
| Stop | ✓ | ✓ | Task turn completed |
| SessionEnd | ✓ | ✓ | Session archived with token usage summary |
Each hook reads the current git state (branch, last commit, uncommitted changes) and sends a small payload to your dashboard. All calls are fire-and-forget with no impact on editor performance.
Importing existing sessions
Backfill your dashboard with past Claude Code sessions:
npx session-intelligence-cli importOptions: --project <name>, --since <date>, --dry-run, --dir <path>.
Updating
If you installed a previous version, re-run setup to register any new hooks:
npx session-intelligence-cli@latest setup --tool claude-code
npx session-intelligence-cli@latest setup --tool cursorCommands
session-intelligence setup --tool <claude-code|cursor> # configure and install hooks
session-intelligence status # check connection and active sessions
session-intelligence import # backfill from Claude Code transcriptsRequirements
- Node.js >= 18
- Claude Code or Cursor
License
MIT
