DSH Plugins Marketplace

DSH Plugins

Plugins

/

Terminal & Clients

/

dsh-git-branch

d

dsh-git-branch

Manifest valid

Show the current workspace git branch beside the composer mode controls, with focus/visibility-driven refresh

UI (client)hasBundlePatch

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.json declares dsh.bundle.patch = ./cordis.patch.yml, which - inserts one git-branch plugin row. dsh plugin add detects dsh.bundle and adds the package to dsh.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; <= 0 disables it.

How it works

  • host: lib/index.js registers the /git-branch command; the handler walks up from session.header.cwd to the nearest .git (worktrees and submodules included), parses HEAD, and returns the result as JSON in the command's text field.
  • client: lib/client.js registers the conversation.input.left chip, fetches the branch through ctx.remote.commands.execute, and registers a conversation.chat.commandview entry for git-branch that renders null, 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

dsh-purge

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.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 9.6k

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-purge-community

by 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

Terminal & ClientsManifest valid

★ 7.8k

↓ 19.2k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile terminal add @deepseek-harness-tui/dsh-tui

by mmparko

DeepSeek Harness 破甲 (mirror of YuJunZhiXue/dsh-purge) — 上游即将删库,此为本仓库全量镜像:含全部分支/73 个 tag/完整提交历史。原作者署名与二开要求见 README 署名章节。

Terminal & ClientsManifest valid

★ 5.3k

↓ 19.5k/wk

MIT

JavaScript

Oct 13, 2026

dsh plugin --profile web add dsh-purge

by 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,

Tools & CapabilitiesUI & ExperienceTerminal & ClientsManifest valid

★ 5.2k

↓ 127.5k/wk

Apache-2.0

TypeScript

Nov 17, 2026

dsh plugin --profile web add dsh-context

by strukto-ai

The World's First Virtual Terminal for AI Agents

Terminal & ClientsManifest valid

★ 3.8k

↓ 519/wk

Apache-2.0

TypeScript

Nov 17, 2026

dsh plugin --profile agent add @struktoai/mirage-dsh

by c1overzz

DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你

Tools & CapabilitiesNotifications & IntegrationsTerminal & ClientsManifest valid

★ 1.4k

↓ 10.5k/wk

MIT

JavaScript

Nov 12, 2026

dsh plugin --profile web add dsh-bili-scroll