dsh-git-ui
A Git status visualizer for DeepSeek Harness (dsh) Web UI — a session-header pill, a detail popover, and a full Git center. No terminal needed.
Read this in 简体中文
At a glance
- Pill — branch · dirty counts (
+N −N ?N) · ahead/behind at a glance
- Popover — recent commits, changed files, branch operations, one click from the pill
- Git center — four tabs: History (the landing tab), Changes, Records, Settings
Session-header pill & detail popover
A status capsule in each session header. Click it for the detail popover — repository root, status counts, recent commits, changed files with inline stage / unstage / discard, and branch operations:
Session-header pill and the detail popover
| State | Pill |
|---|
| Clean | ● main |
| Dirty | ● main · +2 −1 ?3 |
| Ahead / behind | ● main · ↑1 ↓2 |
| Detached HEAD | ● (detached HEAD) · a1b2c3d |
| Not a git repo | Dimmed 无 Git 仓库 |
- Recent commits — click one to jump into the History tab, auto-located and selected
- Changed files — click a file to open its diff in the Changes tab; stage / unstage / discard inline
- Branch switcher & create — switch or create-and-switch without leaving the popover
- Gear icon — straight to Settings; the popover's section order is customizable there
Git center
Opened from the popover — the center keeps all four tabs mounted, so selections, filters and scroll positions survive tab switches. History is the default landing tab.
History
A paginated commit list with a rendered branch graph — windowed rendering keeps thousands of rows smooth, and the selected row lights up with a glowing track (cyber-style, reduced-motion aware):
Git center — History tab overview
- Filter tree — branches / tags / author / date / text-or-hash; prefixed branch groups (
feat/*, fix/*, remote origins) start collapsed for a tidy list; a fetch button syncs remote refs
- Date filter —
今天 means today since local midnight (not the last 24 h); 24 小时内 and 7/30/90-day ranges are separate options
- Search — text or hash prefix with a one-click clear button
Selecting a commit shows its subject · body · changed-file tree (foldable, status-colored). Clicking a file in the tree jumps to the Changes tab and shows that file's diff as of that commit, marked by a commit-hash badge:
Git center — commit details and changed-file tree
Changes
IDE-style groups (staged / unstaged / untracked), per-file & bulk stage / unstage / discard (two-step confirm), and a commit box:
Git center — Changes tab with the diff viewer
The diff viewer:
- View modes —
对照 (side-by-side, default) / 变更前 / 变更后; the split divider is draggable (20%–80%)
- Markdown rendering —
.md files get a 渲染 mode: formatted headings, lists, tables and fenced-code highlighting; mermaid diagrams render natively (with a source/rendered toggle and a clear parse-error fallback)
- New / deleted files — pure-add and pure-delete diffs render the full file content in a single column, with a
新增 / 已删除 badge
- Syntax highlighting & context folding — tokenized once per file, foldable long unchanged runs
Records
Turn work records answer "what did this round touch, and who touched it":
Git center — Records tab (turn work-record timeline)
- Pill badge — unread
new N plus three-way counts: 本 this session's agent · 会 other sessions' AI · 外 human edits
- Working-period timeline — consecutive turns merge into period cards with the task narrative, time window and three-way file groups (still dirty / committed / reverted / gone); periods with no output stay expandable with a
无变更产出 mark
- Actions — bulk-stage "AI changes" or everything; committed entries deep-link to the exact commit in History, auto-located
- Confidence & correction — authoritative entries get solid badges, heuristic ones dashed
≈; hover and press ⇄ to reclassify authorship (persisted per repository)
- New-output marking — each turn's boundary fingerprint marks this round's entries
新
Settings
Display presets (minimal / standard / full, purely derived — tweaks snap back when they match a preset again), per-component switches for pill and popover, popover section ordering, and diff-viewer options:
Git center — Settings tab
- Pill vs popover — independent switches, including the work-record badge (pill) and the work-record section (popover), controlled separately
- Popover sections — reorder with up/down arrows; hidden sections stay in the sequence and appear at their position when enabled
- Diff viewer — code font size, syntax highlight, context folding;
最近提交 count (0 = hidden)
Installation
Requires a running DeepSeek Harness with the web profile:
dsh plugin --profile web add dsh-git-ui
Restart dsh web. Open a session in a git repository and the pill appears in the header. Remove with dsh plugin --profile web remove dsh-git-ui.
Local development install: dsh plugin --profile web add ./ links this repo.
Keep the dev peer symlinks in node_modules/@deepseek-ai/* (see Development).
Usage
- Open a session whose working directory is inside a git repository.
- Read the pill any time — no action needed.
- Click the pill to inspect counts, recent commits and changed files; open the Git center for full management.
Each session shows the status of its own working directory; non-repository sessions show a dimmed placeholder.
Configuration (optional)
All defaults work out of the box. Advanced users may override the plugin config in the profile's cordis.patch.yml:
- id: git-ui
config:
defaultRefreshIntervalMs: 60000 # polling interval (ms); 0 disables polling
maxChanges: 200 # max changed-file entries in a snapshot
timeoutMs: 3000 # per git-command timeout (ms)
maxStatusBytes: 8388608 # status-output cap before truncation
dshHome: /path/to/harness-home # optional: Harness home (default $DSH_HOME → ~/.dsh)
Requirements
- Node.js
^22.19.0 || >=24.0.0
- dsh
>= 0.1.0-rc (developer preview)
git on the host machine
Known limitations
- Shows the session's working directory only; push / pull / merge are not exposed.
- Refresh is polling-based (default 30 s); event-push via file watchers is planned.
- The changed-file list is capped (
maxChanges), with spill-file recovery for oversized status output.
- The browser only ever sends a
sessionId — the host resolves cwd and runs git with path guards.
- Turn records are heuristic for dynamically-constructed bash targets (
$(...), globs, eval) — they fall back to 外 with a visible ≈ mark; cold sessions are skipped; observation timelines are capped.
- Syntax highlighting ships a bundle-budget language subset; mermaid support covers flowchart / graph and sequenceDiagram subsets.
Development
pnpm install
# Link the host-provided peers so a local profile install resolves them:
mkdir -p node_modules/@deepseek-ai
for p in "$HOME"/.dsh/profiles/node_modules/@deepseek-ai/*; do
ln -sfn "$p" "node_modules/@deepseek-ai/$(basename "$p")"
done
pnpm run typecheck && pnpm test && pnpm run build
dsh plugin --profile web add ./ # local install; restart dsh web to verify
Architecture
The plugin is layered to isolate the dsh platform behind a narrow adapter seam:
flowchart TB
subgraph Biz["Business Layer — zero dsh imports"]
HostBiz["src/host/ · core / actions / queries / parser"]
ClientBiz["src/client/ · controller / GitPill / GitCenter"]
end
subgraph Contracts["Contracts Layer — stable interfaces"]
C["src/contracts/ · host-endpoints / client-platform / ui-primitives"]
end
subgraph Adapters["Adapters Layer — the only dsh-aware code"]
A["src/adapters/dsh/ · client-adapter / ui-primitives / types"]
end
HostBiz --> C
ClientBiz --> C
C --> A
A --> DSH["dsh platform · cordis / typert / ui-primitives"]
src/contracts/ — the plugin's own stable interfaces, no dsh importssrc/host/ / src/client/ — business logic against those interfacessrc/adapters/dsh/ — the only place importing @deepseek-ai/*; a dsh upgrade only changes here
License
MIT
