HN 표시: Nv – 병렬 에이전트 워크플로를 위해 구축된 jj용 작업 공간 조정자

Workspace management for Jujutsu, built for parallel human and AI agent workflows. jj workspaces are great for parallel work, but the workflow around it is quite cumbersome: - Paths are unmanaged. jj workspace add ../name works, but paths are arbitrary and easy to forget. - Cross-workspace visibility is stale. jj snapshots the current workspace when you run a command, but not the others. So jj log from one workspace can show outdated commits for the rest — files on disk exist, but jj hasn't recorded them yet. - Cleanup is awkward. Forgetting a workspace does not delete its directory, and deleting a directory does not forget the workspace. There is also no guard against removing the one you are currently in. - Switching doesn't switch your shell. jj workspace changes the working copy, not your terminal's current directory. jj-navi manages workspace lifecycle: naming, paths, switching, visibility, and cleanup. switch --create — go to a workspace, creating it at a deterministic path if it doesn't existlist — snapshot each workspace and show path health, diff stats, commit info, and agemerge — merge work from another workspace into the current or named workspaceremove — forget a workspace and delete its local directory; refuses current workspace With shell integration installed, navi switch also changes your current directory. repo/ ├── repo current workspace ├── repo.feature-auth navi switch --create feature-auth └── repo.fix-api navi switch --create fix-api Without jj-navi jj workspace add ../repo.feature-auth cd ../repo.feature-auth # ... do work ... cd ../repo jj log # stale view of other workspaces jj workspace list # names only jj workspace forget feature-auth rm -rf ../repo.feature-auth # directory left behind With jj-navi navi switch --create feature-auth # ... do work ... navi switch - navi list # snapshotted, with diff stats and age navi remove feature-auth # asks before deleting the workspace directory # npm npm install -g jj-navi # cargo cargo install jj-navi --version 0.2.2 Binaries: navi , nv Minimum jj : 0.39.0 Minimum Node.js (tested): 24 Install once so navi switch can update your shell's current directory: navi config shell install --shell zsh source ~/.zshrc Supports bash and zsh . This adds a managed block to your shell rc file. navi doctor navi switch --create feature-auth navi list navi switch - navi remove feature-auth navi switch # switch to a workspace navi cd # alias for switch navi switch - # switch to previous workspace navi switch @ # switch to current workspace explicitly navi switch --create # create and switch navi switch -c navi switch --create --revision # create from a revision navi switch -c -r navi list # human-readable workspace inventory navi ls # alias for list navi list --json navi list -j navi list --json --compact navi list -j -c navi doctor [--json] [--compact] # diagnose repo, workspace, and shell state navi doctor [-j] [-c] navi merge --from # merge a workspace into the current workspace navi merge -f navi merge --from --into navi merge -f -i navi remove # forget a workspace and delete its directory navi rm # alias for remove navi remove --yes # skip destructive confirmation navi remove -y navi config shell init navi config shell install [--shell ] navi config shell install [-s ] Config and metadata live inside shared Jujutsu storage: .jj/repo/navi/config.toml .jj/repo/navi/workspaces.toml Default workspace path template: ../{repo}.{workspace} switch can recover from missing jj workspace-path records when it can validate a fallback pathswitch warns when it falls back to template-based path resolutionlist snapshots healthy workspaces before rendering so parallel changes are visiblelist reports missing, stale, or not-current workspaces instead of hiding themlist --json exposes structuredfreshness ,diff , andage fieldsremove forgets a workspace and deletes its directory after confirmation;--yes skips the prompt- Supported shells: bash ,zsh Inspired by: