Jam for VSCode
Codebase intelligence inside your editor. Git explained in English, TODO tracking with blame, dependency analysis, health dashboards, pre-commit verification. Integrates with GitHub Copilot.
Website | Jam CLI | npm
Features
Git WTF — Repo State in Plain English
Cmd+Shift+P > "Jam: Git WTF"
Tells you exactly what's happening in your repo:
- Branch name, upstream tracking, ahead/behind counts
- Detached HEAD, mid-rebase, mid-merge detection with fix commands
- Merge conflicts with step-by-step resolution guide
- Stash count, untracked files
TODO Tree
Sidebar panel showing all TODO/FIXME/HACK/BUG comments across your codebase. Grouped by type, click any item to jump to the exact line. Includes git blame info (who wrote it, when).
@jam in Copilot Chat
Type @jam in the Copilot Chat panel to access all Jam commands:
@jam /wtf — explain git state
@jam /todos — list all TODOs
@jam /standup — your recent commits
@jam /verify — run pre-commit checks
@jam /stats — codebase health dashboard
@jam /deps — import dependency graph
@jam /vibes — codebase vibe check
@jam /oops — common git mistake fixes
@jam /cleanup — preview branches to delete
@jam explain this — explain selected code (uses Copilot LM)
Copilot LM Integration
When GitHub Copilot is installed, Jam automatically uses Copilot's language models for AI features. No extra API key, no extra cost — it's included in your Copilot subscription.
- "Jam: Explain Selection" uses GPT-4o/Claude via Copilot
@jam free-form questions use Copilot LM- Falls back to Jam CLI's configured provider if Copilot is unavailable
Pre-commit Verify
Click the Verify button in the Source Control panel or run Cmd+Shift+P > "Jam: Verify". Checks:
- Secret detection (API keys, passwords)
- Lint status
- TypeScript errors
- AI code review
Results appear in the Problems panel as warnings/errors.
Quick Explain
Right-click any code selection > "Jam: Explain Selection". Gets a concise explanation using Copilot's LLM (or falls back to Jam CLI).
Status Bar
Always-visible git status in the bottom bar:
- Branch name with clean/dirty/conflict indicator
- Click to see full
jam git wtf output
- Auto-refreshes on file save
Codebase Stats
Cmd+Shift+P > "Jam: Codebase Stats" — instant LOC count, language breakdown, complexity hotspots, churn analysis.
Commands
| Command |
Shortcut |
Description |
| Jam: Git WTF |
— |
Explain repo state in plain English |
| Jam: Git Standup |
— |
Your commits in the last 7 days |
| Jam: Git Oops |
— |
Common git mistakes and fixes |
| Jam: Git Cleanup |
— |
Preview merged/stale branches to delete |
| Jam: Codebase Stats |
— |
LOC, languages, complexity hotspots |
| Jam: Dependencies |
— |
Import graph, cycles, orphans |
| Jam: Verify |
— |
Pre-commit checks (secrets, lint, types) |
| Jam: Vibes |
— |
Codebase vibe check |
| Jam: Explain Selection |
Right-click |
Explain highlighted code |
| Jam: Refresh TODOs |
— |
Refresh the TODO tree view |
Requirements
- VSCode 1.93+
- Jam CLI — auto-installed on first activation, or:
npm install -g @sunilp-org/jam-clibrew tap sunilp/tap && brew install jam-cli
- GitHub Copilot (optional) — enables AI features at no extra cost
How It Works
This extension is a thin UI layer over the Jam CLI. Every command shells out to jam with --json flags and renders the results in VSCode.
- Zero-LLM commands (git wtf, todos, stats, deps, verify) run via the CLI — instant, offline, no API key
- AI commands (explain, free-form questions) route through Copilot's Language Model API — free with your Copilot subscription
- Fallback — if Copilot isn't available, AI commands use whatever provider Jam CLI is configured with (Ollama, Anthropic, OpenAI, Groq, or Embedded)
Privacy
- All zero-LLM features run entirely on your machine
- AI features use Copilot's models (same privacy as GitHub Copilot)
- If using Ollama as fallback, code stays fully local
- No telemetry, no tracking, no data collection by this extension
Links
Made by Sunil Prakash | MIT License
