dsh-git-ui

August 27, 2026 · View on GitHub

npm version npm license npm downloads

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
StatePill
Clean● main
Dirty● main · +2 −1 ?3
Ahead / behind● main · ↑1 ↓2
Detached HEAD● (detached HEAD) · a1b2c3d
Not a git repoDimmed 无 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

  1. Open a session whose working directory is inside a git repository.
  2. Read the pill any time — no action needed.
  3. 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 imports
  • src/host/ / src/client/ — business logic against those interfaces
  • src/adapters/dsh/ — the only place importing @deepseek-ai/*; a dsh upgrade only changes here

License

MIT