| name | managing-starship-fork |
| description | Sync, build, and install the custom starship fork with jj support. Use when updating starship, rebuilding the binary, syncing with upstream, or modifying the jj_status module. |
Starship Fork Management
Manage the custom starship fork at ~/Projects/starship (origin: TrevorS/starship, upstream: starship/starship). The fork adds a jj_status module for Jujutsu VCS support on branch claude/add-jujutsu-support-JuqjU.
Repo Layout
- Origin:
TrevorS/starship (the fork)
- Upstream:
starship/starship
- Feature branch:
claude/add-jujutsu-support-JuqjU
- Binary install path:
~/.local/bin/starship
- Config:
~/.config/starship.toml (stowed from ~/.claude/dotfiles/starship/)
Sync with Upstream and Rebuild
cd ~/Projects/starship
git fetch upstream
git checkout master
git merge upstream/master --ff-only
git push origin master
git checkout claude/add-jujutsu-support-JuqjU
git rebase master
cargo build --release
cp target/release/starship ~/.local/bin/starship
git push origin claude/add-jujutsu-support-JuqjU --force-with-lease
Quick Rebuild (No Sync)
When you've made local changes and just want to rebuild:
cd ~/Projects/starship
cargo build --release
cp target/release/starship ~/.local/bin/starship
Verify
starship --version
starship module jj_status
The jj_status Module
Source files in the fork:
src/modules/jj_status.rs — module implementation (change ID, bookmarks, conflict/divergent/hidden flags)
src/configs/jj_status.rs — config struct and defaults
src/modules/vcs.rs — VCS discovery (detects .jj/ directory)
docs/config/README.md — user-facing documentation
Config in starship.toml:
[jj_status]
disabled = false
truncation_length = 12
style = "bold purple"
symbol = "jj "
conflicted = "x"
divergent = "?"
hidden = "o"
ignore_working_copy = true
Running Tests
cd ~/Projects/starship
cargo test jj
cargo test
Notes
- Do NOT open PRs against upstream without explicit approval
- The fork's master should always be a clean fast-forward of upstream
- All custom work lives on the feature branch
- Build takes ~90s on first compile, incremental builds are much faster