---

What you get

Branch switcher	Search, switch, create. ↑N ↓M ahead/behind, ✓ in sync, ● local-only.
Commit graph	SVG rails with merge curves in living color — rings for merges, branch lines that join back. Click any row to expand it.
Commit preview	Files (A/M/D), +ins −del, message body, author, timestamp. Hover any row for the gist.
Who's who	Every author gets their own dot color — scan a hundred commits at a glance.
Footer dock	An always-on branch dropdown + recent commits docked above Settings. Follows your open session, hides on non-git workspaces. Click the header to collapse, drag (or focus and use arrow keys on) the top edge to resize — it remembers.
Pull / fetch	One button. It fetches when you are in sync and fast-forwards when you are behind, and tells you what happened.
⚡ Fast	Status + branches + graph in one batched host call, cached, skeleton placeholders — no empty flashes.

Every host git command runs under a deadline, so a stalled repository degrades into an error instead of wedging the panel.

Tour

Install

dsh plugin --profile web add dsh-web-git-sidebar

Restart the web UI once (new host routes), refresh — the Git icon appears in the left rail.

Local hacking? Clone and link it instead:

git clone https://github.com/RaditPasya/dsh-web-git-sidebar.git
dsh plugin --profile web add link:$(pwd)/dsh-web-git-sidebar

Dev loop

pnpm install
node scripts/build.mjs            # lib/index.js (host) + lib/client.js (browser)
MINIFY=0 node scripts/build.mjs   # dev variant: readable output, intact stack traces

Builds are minified by default (the client bundle is ~45% smaller raw, ~22% smaller gzipped). Use MINIFY=0 when you want to read the emitted JS or get usable host stack traces.

link: installs pick up rebuilds live — just refresh the page. Host-side changes (anything under src/host/ or src/index.ts) need a DSH restart, because the host bundle is loaded once at startup.

Three gates, all run in CI on every push and again before publishing:

pnpm run typecheck   # tsc --noEmit, strict, with noUnusedLocals
pnpm test            # builds lib/, then runs every suite under test/

pnpm test bundles each test/*.test.ts with esbuild into a temp directory and hands it to node --test — the sources use TypeScript parameter properties, which Node's native type stripping rejects. The suites cover the git command deadline, flight eviction, the poll backoff policy and the mutation guards, plus smoke tests that load the built bundles, so a minification or bundling regression fails pnpm test rather than the browser.

src/
├── core/        git vocabulary: commands, parsers, wire types
├── host/        workspace-gated service + /git-sidebar/* routes + SSE
└── client/
    ├── api.ts       typed fetch client
    └── sidebar/     icon · panel · footer dock · shared kit

test/            bundled by scripts/test.mjs and run with node --test
scripts/         build.mjs (esbuild) · test.mjs (bundle + run suites)

License

MIT — the industry-standard permissive license. You are free to use this software commercially, modify it, distribute it, sublicense it, and sell copies of it. The only requirements: keep the copyright notice and this permission notice in all copies. The software is provided "as is", without warranty of any kind, and the authors are not liable for any claims or damages. See LICENSE for the full text.