Skip to content

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

Terminal window
npx jig-dev init

This 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.

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