Getting Started
Get Jig running in under 2 minutes. Choose your path:
Quick start
The fastest way to use Jig. Connect it to Claude and start working immediately.
1. Install the CLI
npx jig-dev initThis scaffolds a .jig/ directory and registers Jig as an MCP server in Claude Code automatically.
2. Verify the connection
Open Claude Code settings and confirm jig-mcp appears under MCP Servers with status Connected.
If it’s missing, add it manually:
{ "mcpServers": { "jig-mcp": { "command": "npx", "args": ["jig-dev", "mcp"], "cwd": "/path/to/your/project" } }}3. Your first spec
Ask Claude: “Create a spec for [feature you want to build]”
Claude will use Jig’s MCP tools to create the spec, decompose it into tasks, and start executing — all within the conversation.
For power users who prefer the command line.
1. Install
npx jig-dev init2. Create your first spec
jig spec new my-feature --layer surfaceEdit the spec file at .jig/specs/my-feature.md with your feature description.
3. Decompose into tasks
jig decompose my-feature4. Start working
jig nextjig task start <task-name># ... do the work ...jig task done <task-name> --notes "What changed and why"Prerequisites
- Node 18+ (or Bun 1.0+)
- Claude Code with an active subscription (for MCP path)
What just happened
jig init created a .jig/ directory at your project root. This is where all specs, tasks, context bundles, and run logs live. It also registered Jig as an MCP server so Claude can read and update task state while it works.
Next steps
- Concepts — understand specs, tasks, verification, and requests
- CLI Reference — every command and flag
- MCP Reference — every MCP tool documented
- Guides — step-by-step walkthroughs