Cadence

Local insights for Copilot, Claude Code, Codex, Cursor, and OpenCode inside VS Code and Cursor.

Cadence reads session logs already on your machine, shows habits worth fixing, and stays offline. It does not send telemetry or change your logs.

  Observe  →  Measure  →  Improve  →  Level Up
  sessions    charts      signals     practice

Install

Marketplace (recommended)

Open Extensions in VS Code or Cursor
Search Cadence (publisher badrusiddique)
or open the Marketplace listing
Install, then Command Palette → Cadence: Open Overview
If you have no local logs yet, turn on Settings → cadence.demoMode

VSIX from source

git clone https://github.com/badrusiddique/cadence.git
cd cadence
npm ci
npm run package
code --install-extension cadence-insights-1.2.3.vsix
# or: cursor --install-extension cadence-insights-1.2.3.vsix

Windows PowerShell blocking npm:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
# or use Command Prompt / npm.cmd

Browser preview (no extension)

npm ci
npm run preview

Open http://127.0.0.1:43127 for fixture data and the full dashboard.

Full walkthrough: docs/GETTING_STARTED.md

Features

Area	What you get
Observe	Dashboard, day-grouped timeline, coding moments
Measure	Output charts, burndown estimates, patterns, curiosity, flow, hub
Improve	Habit signals, Rule Studio, Signal Lab, skill finder, context health
Level Up	Practice drills, achievements, lifecycle mix, shareable snapshot
Agents	CLI, stdio MCP, `@cadence` chat, LM tools

Useful details:

Offline by default (no cloud coaching account)
Burndown is always available and labeled as estimates, not billing
One view across Cursor, Claude, Codex, Copilot, and OpenCode
Custom rules: Lab → Save draft → Approve → load

Everyday use

Open Overview
Filter with Current/All, date range, and harness
Check Anti-Patterns; use Rule Studio for a custom signal if you want one
Export Snapshot for a shareable weekly card

npm run cli -- doctor --json
npm run cli -- overview --demo --json
npm run cli -- habits --demo --json
npm run mcp
npm run setup:mcp

In-editor: @cadence /summary, /habits, /compare, /flow

Supported harnesses

Harness	Typical path
VS Code / Copilot chat	`.../User/workspaceStorage/*/chatSessions`
Cursor	`workspaceStorage` + `~/.cursor/projects/**`
Copilot CLI	`~/.copilot/session-state`
Claude Code	`~/.claude/projects/*/.jsonl`
Codex CLI	`~/.codex/sessions/*/.jsonl`
OpenCode	`~/.local/share/opencode`

Reads are read-only. Session files are never mutated.

Privacy

Local analysis only
Personal signals under ~/.cadence/signals need explicit Approve before they load
Lab predicates use a sandboxed parser (no eval / Function)
Defaults include offline webview CSP, RPC allowlist, ingest caps, optional export redaction
See SECURITY.md, docs/ENTERPRISE.md, docs/SIGNALS.md

Develop

npm ci
npm run check
npm run build
npm run preview
npm run package

Path	Role
`src/ingest/`	Discover and parse harness logs (capped)
`src/analyze/`	Analytics for UI and LM tools
`src/signals/`	Habit SignalSpec engine and catalog
`src/ui/`	Preact dashboard
`src/host/`	Panel, RPC guard, chat, tools
`src/cli/` · `src/mcp/`	Doctor, overview, MCP server

Docs

Doc	Purpose
Getting started	Install, first session, demo mode
Enterprise	Org rollout and privacy controls
Signals	Author habit rules
Marketplace	Publish to VS Marketplace / Open VSX
Architecture	How the pieces fit
QA vs AEC	Comparison notes
NOTICE	Prior art disclosure

Commands

Cadence: Open Overview
Cadence: Reload Sessions
Cadence: Export Snapshot
Cadence: Review Local Signals

License

Same problem space as Microsoft’s MIT-licensed AI Engineering Coach. See NOTICE. Not a fork.

Cadence: Agent Engineering Insights

Badru Siddique