Documentation Index
Fetch the complete documentation index at: https://docs.joggr.ai/llms.txt
Use this file to discover all available pages before exploring further.
/gg-task and plan review
jog gg itself: Quick Mode collapses the full discuss → research → plan → execute → verify sequence into a single /gg-task call for small, well-scoped changes. Three checkpoint gates keep you in the loop at the right moments without forcing the whole multi-phase ceremony.Plan review is the second big piece. Hook jog app --plan into Claude Code and every time Claude exits plan mode, an interactive review opens in your browser — annotate the plan, approve it, or send it back with feedback that flows directly into the next turn. Catches over-scoped or off-track plans before any code gets written./gg-taskskill — single-session workflow for simple tasks. Run/gg-task "your task"and walk through discuss, research, plan, execute, and verify in one pass with checkpoint gates between phases.jog app --planplan review — registers a Claude Code hook that opens an interactive plan review when Claude enters plan mode. Reviewer annotations come back as structured feedback.
Improvements
jog sandbox prune— batch-remove sandboxes whose PRs have already merged. Interactive picker by default, plus--all,--dry-run,--force, and--yesflags for scripting.
jog sandbox info
jog sandbox list table picks up a PR column at the same time, so you can see at a glance which branches have an open review and which are waiting on you to push.jog sandbox info [name]— full detail view; run without a name for an interactive picker.- PR column in
jog sandbox list— each branch shows its open PR number (or-if none).
Improvements
- Tilde-prefixed paths — sandbox views render
~/...instead of full home paths. - Tighter table layout —
jog sandbox listand other tables get column gap spacing for easier scanning.
Bug fixes
@filereferences resolve —/gg-review @docs/standards/git-pulls.mdnow works in Claude Code; the leading@is stripped automatically.jog sandbox remove— no longer fails when a sandbox’s worktree directory is missing or malformed.
/gg-review opens any file or directory
/gg-review used to be scoped to GG project documents. Point it at any file or any directory and it’ll work — file mode for a single document, directory mode with a file tree in the sidebar. Run /gg-review @path/to/file.md for a single file or /gg-review @docs/ to walk a directory.- Any markdown, anywhere — point
/gg-reviewat any file or directory in your repo. - Directory mode — sidebar shows the full file tree so you can navigate as you review.
Improvements
- Quieter terminal — long-running CLI commands no longer hijack the terminal with spinners.
Bug fixes
- Cleaner review viewer — table rendering and empty-paragraph spacing fixed in the review output.
Checkpoints without the commit
checkpoint.auto_commit: false and jog gg checkpoint save will skip the git operations entirely — files stay in your working tree for manual review.checkpoint.auto_commitsetting — set tofalseto skip git operations. Files stay in your working tree for manual review.- Local config overrides —
.joggr/config.local.json(or.yaml) deep-merges over your base config, so per-machine tweaks don’t require forking the whole file.
Bug fixes
- Checkpoint save with multiple files —
jog gg checkpoint save "msg" --files a.ts b.ts c.tsnow actually saves all listed files. Previously only the first one was committed.
GG fixes its own PR reviews
/gg-pr-fix-review <pr-number>. The skill has two modes: ask mode pauses before each thread so you can confirm or redirect; auto mode resolves the whole queue and re-runs itself when bot reviewers come back with new comments.If you’ve ever finished a PR only to spend the next hour walking back to the terminal to address every CodeRabbit nit, this is the workflow you’ve been waiting for.gg-pr-fix-reviewskill — fetches unresolved threads, fixes the code, replies to invalid feedback, resolves on success. Distributed viajog initfor Claude Code and Cursor.askandautomodes —askconfirms each step;autoresolves the whole queue and loops on bot re-reviews.
Improvements
- Project picker for review mode — switch projects without leaving the review UI.
Bug fixes
- Portable codebase docs —
/gg-codebaseno longer writes absolute paths into the generated.joggr/.gg/codebase/files, so the same docs work across machines and worktrees. - macOS sandbox attach with long branches — no longer hangs when branch names exceed the Unix socket path limit. You now get a clear error message instead of a frozen terminal.
Sandboxes get a status bar
- Sandbox status bar — local sandbox sessions show sandbox type, branch name, and copy/detach hints at the bottom of the pane.
Bug fixes
- Errors during
jog sandbox createactually surface — failures used to exit silently. They now render the error phase with the message. - No more blank init screens —
jog initstopped rendering on certain terminals (Apple Terminal, some SSH clients). Fixed.
Run GG in Cursor
jog init and the same skills, rules, and project workflow you’ve been using land in the locations Cursor expects — no manual file shuffling, no provider-specific forks of your config.- Cursor as a GG provider — pick Cursor in
jog init; skills and rules land in the locations Cursor expects.
Smoother sandbox sessions
Bug fixes
- No more input lag — fixed severe stdin lag when attaching to sandbox sessions in Terminal.app and iTerm2.
- Stable sandbox layouts on slower machines — sandbox sessions on Intel Macs no longer come up with broken layouts or hidden UI chrome from a
create/attachrace. - No more global multiplexer interference — sandbox sessions ignore your personal multiplexer config, so a custom global setup can’t bleed into a sandbox.
- Correct GG skill descriptions — Claude Code now shows the real description for each GG skill instead of the copyright header.
Meet /gg
/gg-new starts a project, /gg-discuss clarifies requirements, and the rest of the /gg-* family takes you through to a verified merge.Run jog init and pick “Set up guided workflows (GG)” to wire the skills into Claude Code or Cursor./gg-*slash commands —/gg-new,/gg-discuss,/gg-research,/gg-plan,/gg-execute,/gg-verify, and/gg-statuscover the full workflow.jog initintegration — pick “Set up guided workflows (GG)” to install the skills.- Mouse scrolling in sandboxes — sandbox sessions now respond to scroll wheel input.
Bug fixes
jog updatepicks the right install — global npm installs are no longer misclassified as local. If you’ve installed locally, you get a boxed warning recommending a global install.- No more hanging sandbox commands —
jog sandboxsubcommands cleanly exit instead of leaving orphaned child processes behind.
jog sandbox is here
jog sandbox create | list | attach | remove | shell is your full lifecycle, with attach doing the heavy lifting: sessions prepare in the background so attach is instant, and any configured lifecycle commands auto-run when you join. Login also becomes mandatory by default, and the binary picks up joggr as a second name.jog sandbox create | list | attach | remove | shell— full lifecycle for agent sandbox environments.joggralias — invoke the CLI as eitherjogorjoggr. Same binary, two names.
Improvements
- Login required by default — every command requires
jog auth loginfirst.auth,update, and--helpare exempt; other commands can opt out via glob patterns. - Faster sandbox attach — sessions prepare in the background; lifecycle commands auto-run on attach.
- Better remove UX —
jog sandbox removeshows per-sandbox progress and auto-exits when nothing’s left.
Bug fixes
- Bundled tools run on first install — fixed
ENOENTfailures when the CLI tried to invoke its bundledast-grep,rg,fd, and multiplexer binaries.
Console brand refresh
- Collapsible right sidebar — toggle a context panel from the top bar without losing the main nav.
Improvements
- New brand mark — updated full logo, rounded/square icons, and SVG favicons in light and dark.
- Sharper icons — higher-resolution app icons across home screens and browser tabs (up to 512×512).
Flag renames for jog init
jog init. The --prompt flag becomes --guidance (-g) to better describe what it does, and the --providers short alias moves from -t to -p so it lines up with the long form. jog init --guidance also no longer needs --providers to start.Improvements
jog init --guidance— auto-starts without requiring--providers.
jog init, redesigned
jog init gets a redesigned screen — charts, tabs, and a richer post-run report so you can see exactly what landed where. The release also adds a dirty working tree check: jog init now refuses to run on a repo with uncommitted or untracked changes, so a misfired run can’t bury work-in-progress under generated config.- New init screen — charts, tabs, and richer report data after a run completes.
- Dirty working tree check —
jog initblocks execution if you have uncommitted or untracked changes. Commit or stash first.
Improvements
- Node 22 support — minimum engine drops from
>=24.0.0to>=22.0.0.
Worktree sandboxes
- Worktree-backed sandboxes — manage isolated git-worktree sandboxes from the CLI.
Bug fixes
- Cleaner errors — failures from the native binary now show a clear message instead of a stack trace.
jog launches
@joggr/cli from npm, run jog auth login, and you’re in.@joggr/cli— thejogcommand, your entry point to everything.jog auth login | logout | status— three ways to authenticate: environment variable, file-based, or interactive prompt.- Joggr console — the web UI at console.joggr.ai for browsing actions and results.