Skip to content

CLI Reference

The Jig CLI (jig) is the command-line interface for managing specs, tasks, verification, and the full development lifecycle.

Install

Terminal window
npx jig-dev init

This scaffolds a .jig/ directory and registers the MCP server. After init, the jig command is available via npx jig-dev or globally if installed.

Command categories

  • Specs — create, list, show, update, archive, and delete feature specs
  • Tasks — manage task lifecycle: start, done, fail, cancel, blocked
  • Execution — run tasks via Claude Code, verify gates, view run history
  • Bundles & Snippets — reusable context for task execution
  • Criteria — structured acceptance criteria for mechanical verification
  • Intake — file bugs and ideas, triage findings
  • Requests — track intent and link work to reasons
  • Environments — deploy to staging, promote to production

Global flags

FlagDescription
--verboseShow full stack traces on error
--jsonOutput as JSON (machine-readable)
--briefCompact one-line-per-item output
-V, --versionShow version

See All Commands for the complete reference with usage, flags, and examples.