Quick start

Copy this workflow if you want to understand gji in under two minutes.

This matters even more when you keep multiple human and AI-assisted tasks open in parallel.

Start a task

gji new feature/dark-mode

That creates a branch, creates a worktree, and moves your shell into it when shell integration is enabled.

If you want temporary investigation space without naming a branch yet:

gji new --detached

Review a pull request

gji pr 1234
gji pr https://github.com/org/repo/pull/1234

Jump between contexts

gji go feature/dark-mode
gji go repo-a/main
gji go feature/dark-mode
gji back       # return to the previous worktree
gji back 2     # go two steps back in history
gji go main
gji go --root
gji root

Use gji go for navigation. Its chooser starts in the current repository; press Tab to include every registered repository. The older gji warp command remains available as a deprecated navigation compatibility command.

gji back returns you to the last worktree you were in — like cd - but for worktrees. Pass a number to jump further. Use gji history to see where you've been.

Check what is open

gji status
gji ls

Use ls when you want a detailed worktree list and ls --compact when you only need branch and path.

Keep branches current

gji sync
gji sync --all

Clean up when done

gji done feature/dark-mode
gji clean

Use done for one linked worktree and clean to prune several stale worktrees in one interactive pass. The older remove/rm commands remain available with a deprecation warning for compatibility.