Commands
Quick reference for all jig commands.
Worktree management
| Command |
Description |
jig create <name> |
Create a worktree (-o to cd into it) |
jig list |
List all worktrees (-g for global, --all to include base repo) |
jig open <name> |
Navigate to worktree directory |
jig remove <name> |
Remove worktree(s) — supports glob patterns (-f to force) |
jig exit |
Remove current worktree and cd to repo root |
jig home |
Navigate to base repository root |
Sessions
| Command |
Description |
jig spawn <name> |
Create worktree + launch agent session (--issue, --context) |
jig ps |
Show worker status dashboard |
jig ps -w |
Watch mode with live updates |
jig ps -gw |
Global watch — all repos, live updates from the running daemon |
jig daemon start |
Run the daemon in the foreground (--once for a single tick, --timeout to bound its wait) |
jig daemon stop |
Stop the running daemon |
jig daemon status |
Check the daemon is alive, ticking, and not stuck (default for jig daemon) |
jig daemon logs |
Print the daemon’s log (-f to follow, -n lines, --path) |
jig daemon install |
Run the daemon as an OS service — a system service on Linux (needs sudo, keeps your groups), a launchd agent on macOS. --as <user> runs it as a service account, --env KEY=VALUE adds environment, --user installs without sudo |
jig daemon uninstall |
Remove that service (--user for the user one) |
jig attach <name> |
Attach to a worker’s agent session (-g to search all repos, --repo to target one) |
jig kill <name> |
Kill a worker’s agent session (-a for all) |
jig nuke |
Kill all workers and clear state (keeps config/hooks) |
Issues
| Command |
Description |
jig issues |
List issues from configured provider |
jig issues <ID> |
View a specific issue |
jig issues create "title" |
Create a new issue (--body, --priority, --label, --category, --parent) |
jig issues update <ID> |
Update an issue (--body, --append, --parent, --blocked-by) |
jig issues status <ID> <status> |
Set issue status |
jig issues complete <ID> |
Mark issue complete |
Issue filters
jig issues --status planned # by status
jig issues --priority high # by priority
jig issues --category Backend # by project/category
jig issues --label backend # by label (all must match)
jig issues --label backend --label bug
PRs
| Command |
Description |
jig pr |
Push and create a draft PR for the current worktree |
jig pr comments |
Show review feedback on the current branch’s PR |
jig pr comments --pr 42 |
Show review feedback for a specific PR |
jig pr comments --between HEAD~3..HEAD |
Filter comments to files changed in a range |
jig pr auto-detects parent issues and targets the parent branch instead of main. See Parent-Child for details.
Configuration
| Command |
Description |
jig init |
Initialize jig in a repository (--audit, --force, --backup) |
jig config |
View/edit configuration (base, on-create, mux, --list) |
System
| Command |
Description |
jig health |
Check system dependencies and repo setup |
jig hooks |
Manage git/agent hooks (init, uninstall) |
jig shell-init <shell> |
Print shell integration script |
jig shell-setup |
Auto-configure shell integration |
jig update |
Update jig to latest version |
jig version |
Show version information |
jig which |
Show path to jig executable |