Skip to main content

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 warp feature/dark-mode
gji warp 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 root

Use gji warp when you want branch-first navigation across every registered repo instead of only the repo you are currently standing in.

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.

Create work in another repo from the same entry point​

gji warp --new fix/copy-regression

If only one repo has been registered, gji creates the worktree there directly. If several repos are known, it lets you pick the target repo first.

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 remove feature/dark-mode
gji clean

clean is the right choice when you want to prune several stale worktrees in one interactive pass.