dsh-git-branch
Manifest validShow the current workspace git branch beside the composer mode controls, with focus/visibility-driven refresh
dsh-git-branch
English | 中文
Show the current workspace git branch right after the composer mode controls (access mode / plan) in the DeepSeek Harness (DSH) Web UI. It renders only when the workspace is inside a git repository, and it refreshes automatically when you switch branches in another tool.
Where it appears
The composer tool row is laid out as [+ commands] [access mode] [plan] ← branch chip. This plugin registers into the conversation.input.left slot — the additive seat immediately after the resident mode chrome — so the branch chip sits right next to the mode controls.
- Branch:
⎇ main - Detached HEAD:
⎇ detached @ a1b2c3d - Not a git repository: nothing renders
- Click the chip: refresh immediately (tooltip explains)
Install
The package is a DSH bundle (it ships its own cordis.patch.yml), so dsh plugin add both installs the dependency and activates it — no manual config:
# from npm
dsh plugin --profile web add dsh-git-branch
# or a local checkout (development)
dsh plugin --profile web add ./dsh-git-branch
Then restart the profile and refresh the page:
# restart dsh web, then reload the browser tab
How it works:
package.jsondeclaresdsh.bundle.patch = ./cordis.patch.yml, which- inserts onegit-branchplugin row.dsh plugin adddetectsdsh.bundleand adds the package todsh.profile.bundles; on the next boot that patch layer takes effect, the host loads the host half, and the client half is served to the browser automatically.
Optional host config
To change the command name, override the row (same id) in your own profile cordis.patch.yml:
- id: git-branch
name: dsh-git-branch
config:
commandName: git-branch # optional; default is git-branch
Unknown config keys fail at load.
Client refresh constant
See the top of src/client/index.tsx (or lib/client.js):
POLL_INTERVAL_MS = 60000: slow safety-net poll;<= 0disables it.
How it works
- host:
lib/index.jsregisters the/git-branchcommand; the handler walks up fromsession.header.cwdto the nearest.git(worktrees and submodules included), parsesHEAD, and returns the result as JSON in the command'stextfield. - client:
lib/client.jsregisters theconversation.input.leftchip, fetches the branch throughctx.remote.commands.execute, and registers aconversation.chat.commandviewentry forgit-branchthat rendersnull, hiding the transport command from the transcript.
Refresh triggers (see DESIGN.md): mount / session-or-workspace switch → immediate; window focus → immediate; visibilitychange → visible → immediate; chip click → immediate; 60s poll → fallback.
Layout
dsh-git-branch/
├── package.json # dsh.bundle + dsh.client + peerDependencies
├── cordis.patch.yml # bundle patch: inserts the git-branch plugin row
├── LICENSE
├── src/
│ ├── index.ts # host half (TypeScript source)
│ └── client/index.tsx # client half (TypeScript source)
├── lib/
│ ├── index.js # host half (prebuilt)
│ ├── index.d.ts
│ ├── client.js # client half (prebuilt, window.__ModuleLoader__ format)
│ └── client.d.ts
├── DESIGN.md # git-branch refresh-rules design
├── README.md # English (this file)
└── README.zh.md # 中文
License
MIT
Comments
Loading…
From the same category
by kingcharleslzy-ai
Community-maintained dsh-purge fork with host-policy patches, prompt and rule settings, diagnostics, separate update-check and install controls, and local backup/rollback.
★ 9.6k
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-purge-communityby ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件:Claude Code 风,鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rol
★ 7.8k
↓ 19.2k/wk
MIT
TypeScript
Nov 17, 2026
dsh plugin --profile terminal add @deepseek-harness-tui/dsh-tuiby mmparko
DeepSeek Harness 破甲 (mirror of YuJunZhiXue/dsh-purge) — 上游即将删库,此为本仓库全量镜像:含全部分支/73 个 tag/完整提交历史。原作者署名与二开要求见 README 署名章节。
★ 5.3k
↓ 19.5k/wk
MIT
JavaScript
Oct 13, 2026
dsh plugin --profile web add dsh-purgeby bowenliang123
The best DeepSeek Harness plugin for context insight and management, with context dashboard / browser / sidebar and context command, for context statistics, composition, breakdown, evolution details,
★ 5.2k
↓ 127.5k/wk
Apache-2.0
TypeScript
Nov 17, 2026
dsh plugin --profile web add dsh-contextby strukto-ai
The World's First Virtual Terminal for AI Agents
★ 3.8k
↓ 519/wk
Apache-2.0
TypeScript
Nov 17, 2026
dsh plugin --profile agent add @struktoai/mirage-dshby c1overzz
DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你
★ 1.4k
↓ 10.5k/wk
MIT
JavaScript
Nov 12, 2026
dsh plugin --profile web add dsh-bili-scroll