Archived
-
v0.1.0 Pre-Release
released this
2026-10-21 18:01:04 +00:00 | 38 commits to main since this releaseFirst release of submarine, a terminal UI for git repositories with many (nested) submodules. This is a prototype: browsing is complete, actions are not yet implemented.
Highlights
- Collapsible tree showing only the submodules, with each pin described as a branch plus distance (e.g.
origin/main ↓1) instead of a bare commit hash. - Reads real repositories through a read-only git provider:
submarine [dir]. - Background fetch on startup (
--no-fetchto skip,fto fetch again), and follows changes made in other shells. - Detail pane previews uncommitted changes.
- Submodules without issues show a muted "in sync".
submarine --mockruns on built-in mock data.
Install
curl -fsSL https://git.simon-franken.de/simonfranken/submarine/raw/branch/main/install.sh | shInstalls
submarineand the aliassub(linux/macOS, amd64/arm64) to~/.local/bin. Update later withsubmarine update.Binaries and
checksums.txtare published in the package registry (generic packagesubmarine, version0.1.0).Known limitations
- The actions
u,b,/and!only show a "not implemented" message.
Downloads
- Collapsible tree showing only the submodules, with each pin described as a branch plus distance (e.g.