v0.6.0 — 40+ commands · multi-provider · privacy-first

Your AI dev toolkit.
Runs on your machine.

Jam is a developer-first AI CLI for the terminal. Ask questions, review diffs, trace call graphs, generate diagrams — all without your code leaving your filesystem.

Install GitHub →
Runs locally by default Code never leaves your machine Swap providers with one flag
~/my-project
$ jam ask "What providers are supported?"
── Planning ──────────────────────────────
│ Intent: Find supported provider implementations
│ Step 1: read_file src/providers/factory.ts
── Searching codebase ─────────────────────
▸ read_file(path="src/providers/factory.ts")
▸ list_dir(path="src/providers/")
── Answer ─────────────────────────────────
Jam supports 5 providers: Ollama (default),
OpenAI, Anthropic, Groq, and Embedded.

See it in action

Ask about your codebase

Jam searches, reads, and synthesizes. It doesn't guess — it reads the actual code before answering.

~/my-project
$ jam ask "How does error handling work?"
── Planning ──────────────────────────
│ Step 1: read_file src/utils/errors.ts
── Searching codebase ─────────────────
▸ read_file(path="src/utils/errors.ts")
── Answer ─────────────────────────────
JamError extends Error with typed error
codes, retryable flags, and actionable
hints for each error scenario.

Smart commits

Auto-detects your project's convention. Conventional Commits, Jira prefixes, or custom patterns.

~/my-project
$ jam commit
Detected convention: {type}({scope}): {desc}
Generating commit message...
Generated commit message:
feat(providers): add quota detection
[main a1b2c3d] feat(providers): add quota detection

Architecture diagrams

Static analysis maps modules, dependencies, and cycles. Generates Mermaid output. AI refinement optional.

~/my-project
$ jam diagram --type architecture
Analyzing codebase...
Found 93 files, 12 modules, 310 imports
graph TD
commands[commands — 37 files]
utils[utils — 14 files]
providers[providers — 7 files]
commands -->|70| utils
commands -->|39| config

Validate before you ship

Secrets, lint, and AI review in one command. Catches problems before they reach your repo.

~/my-project
$ jam verify
Running checks...
[✓] No secrets detected
[✓] Lint passed — 0 warnings
[✓] TypeScript — 0 errors
[✓] AI review — no issues found
All checks passed.

Built for developers

Codebase-Aware AI

Ask questions, explain files, search code. Jam reads your repo for grounded answers.

Verify Before You Ship

Secret scanning, lint checks, AI review — one command validates everything.

Architecture Diagrams

Generate Mermaid diagrams from static analysis. Modules, deps, cycles, symbols.

Multi-Provider + Integrations

Ollama, OpenAI, Anthropic, Groq, Embedded. Plus Jira and MCP server integration.

19 Built-in Utilities

todo, stats, deps, dup, json, convert, hash, env, ports — zero LLM required.

Layered Configuration

Global → repo → CLI flags. Named profiles, secure keychain, shell completions.

Your model, your choice

Ollama OpenAI Anthropic Groq Embedded ProviderAdapter jam

--model claude-sonnet-4-20250514 → Anthropic. No --provider needed.

Default is localhost. Your code stays on your machine.

40+ commands. Many need no AI at all.

todoscan comments statshealth dashboard depsimport graph dupfind clones jsonquery & diff convertformats envmanage dotenv hashchecksum files portslistening ports packpackage analyzer httpquick requests recentchanged files md2pdfmarkdown to PDF doctordiagnostics initproject setup

Up and running in 60 seconds

1

Try instantly

npx @sunilp-org/jam-cli doctor
2

Install

npm install -g @sunilp-org/jam-cli

or brew tap sunilp/tap && brew install jam-cli

3

First command

jam ask "How does auth work in this project?"