Motif

Real-time AI coding productivity dashboard for Cursor. Like StarCraft APM, but for vibe coding.

Motif shows you AIPM (AI tokens per minute), concurrency (how many agents are running in parallel), and session stats — live, in your sidebar and status bar. It reads directly from Cursor's local database and hooks. No API keys. No server. Everything stays on your machine.

Features

Status bar

Always-visible indicator showing current AIPM and concurrency. Color-coded from red (idle) to purple (peak output). Click it to open the dashboard.

Sidebar dashboard

Live metric bars with Unicode block characters — concurrency, average concurrency, AIPM, average AIPM, and per-agent efficiency. Updates every second.

Session tracking

Total tokens, prompts sent, duration, and peak values all tracked per session. Sessions save automatically when you stop tracking or close Cursor.

Personal bests

Records for peak AIPM, peak concurrency, and peak leverage (tokens per prompt). You get a notification when you set a new one.

Multi-window safe

Only one Cursor window polls the database at a time. Other windows enter read-only mode automatically — no double-counting.

How It Works

Motif uses two data sources:

Cursor Hooks — real-time agent start/stop events. On install, Motif merges four entries into ~/.cursor/hooks.json. These fire every time an agent starts or finishes, giving you accurate concurrency tracking.
SQLite polling — Motif reads Cursor's local state.vscdb database once per second to count tokens from assistant messages. It uses a bundled sqlite3 binary so there are no native module compilation issues.

Both sources feed MetricsEngine, which computes a 10-second rolling AIPM window, time-weighted average concurrency, and per-agent efficiency. The status bar shows an EMA-smoothed AIPM to reduce jitter; the sidebar shows the raw value.

Install

From the Marketplace

Search for Motif in the Cursor Extensions panel, or install from the VS Code Marketplace page.

Manual VSIX install

Download the latest motif-x.x.x.vsix.
In Cursor, open the Extensions panel, click the ... menu, and choose Install from VSIX.

Or from the terminal:

cursor --install-extension motif-0.1.0.vsix --force

Note: use cursor, not code. The code command installs into VS Code, not Cursor.

Commands

All commands are available via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).

Command	ID	What it does
Start Tracking	`motif.startTracking`	Begin a new session
Stop Tracking	`motif.stopTracking`	Save current session and stop
Reset Session	`motif.resetSession`	Save current session and start fresh
Show Dashboard	`motif.showDashboard`	Focus the sidebar panel
Show Diagnostics	`motif.showDiagnostics`	Open the Motif output channel — shows DB path, hook status, lock status, and recent errors
End Session	`motif.endSession`	Save session with summary notification and start fresh

Configuration

Setting	Default	Description
`motif.pollInterval`	`1000`	SQLite polling interval in milliseconds
`motif.showStatusBar`	`true`	Show or hide the status bar item
`motif.agentTimeout`	`600`	Seconds before an agent with no activity is removed from the concurrency count
`motif.idleTimeout`	`300`	Seconds of inactivity before auto-saving the session and resetting. Set to 0 to disable

Companion CLI

Motif VS Code tracks your live session. motif-cli goes further — it extracts full conversation history from Cursor and Claude Code, generates your Agentic Coding Assessment (vibe report), and builds personalized AI config files.

PyPI: pip install motif-cli
GitHub: github.com/Bulugulu/motif-cli

Use the extension for real-time awareness while you work. Use the CLI for analysis, reporting, and portfolio building after.

License

Apache 2.0