deepseekplugins

DeepSeek Harness plugin

dsh-client-ui-git-branch

Out-of-tree dsh plugin: a git branch selector in the chat composer, immediately left of the model seat (current branch, fuzzy search, 5-row scroll, switch with conflict toast).

Docs & Rendering
Jump to install

Source facts

Repository
dsh-mixxed/dsh-client-ui-git-branch
Latest update
Aug 16, 2026
Category
Docs & Rendering
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/dsh-mixxed/dsh-client-ui-git-branch
Plugin: dsh-client-ui-git-branch
Author: dsh-mixxed

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-client-ui-git-branch

English | 中文

A dsh (DeepSeek Harness) out-of-tree plugin that adds a git branch selector to the chat composer, immediately left of the model seat (conversation.input.right).

Install

1. Install the plugin from npm (published as @dsh-mixxed/dsh-client-ui-git-branch):

``sh dsh plugin --profile web add @dsh-mixxed/dsh-client-ui-git-branch ``

The package declares dsh.bundle (its bundled cordis.patch.yml), so dsh plugin add automatically appends it to the profile's dsh.profile.bundles layer stack and the plugin mounts on the next boot — no manual cordis.patch.yml editing.

Upgrading an install that predates the bundle declaration: remove the legacy ui-git-branch row from $DSH_HOME/profiles/<name>/cordis.patch.yml — the bundle layer now supplies it, and leaving both would mount the id twice.

2. Restart the profile (new plugins are discovered at boot) and refresh the browser page. In a session whose workspace is a git repository, the branch chip appears left of the model seat.

Building from source (development / offline)

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
npm pack          # produces dsh-mixxed-dsh-client-ui-git-branch-<version>.tgz
dsh plugin --profile web add ./dsh-mixxed-dsh-client-ui-git-branch-<version>.tgz

Features

  • Composer seat left of the model selection, same chip/menu chrome as the model seat
  • Shows only when git is installed and the session workspace is a git repository
  • Fuzzy branch search (substring or in-order subsequence), with a clear button
  • List shows at most 5 rows; more branches scroll inside the list (no page-level scrolling)
  • Current branch marked in a distinct color (brand blue + check icon)
  • Upstream tracking facts (VSCode-style): every branch shows its remote short name

(origin/main) with colored ahead/behind commit counts (↑2 amber / ↓3 green) and a red gone marker when the upstream ref was deleted; local-only branches show nothing. The trigger chip carries the same badge when the current branch is out of sync

  • Local / Remote groups — see [Branch groups](#branch-groups)
  • New branch action: a dialog asks for the branch name, then creates the branch from HEAD and

checks it out (git switch -c); invalid names are flagged live, collisions surface git's message

  • Branch switching with conflict detection: failures pop a transient toast carrying git's stderr
  • Full zh / en i18n and automatic multi-theme support through --dsw-* design tokens
  • Detached-HEAD safe (trigger falls back to HEAD); unborn-HEAD repos still list the current branch

Branch groups

The list is split under two sticky headings:

  • Local branches — every local branch. Tracked branches keep their upstream mapping

(master → origin/master, with ahead/behind counts).

  • Remote branches — only branches that exist remotely but have no local counterpart

(origin/HEAD symrefs and bare remote refs are excluded).

Behavior:

  • The fuzzy search spans both groups at once; a group with no matches collapses away.
  • Clicking a remote branch creates a local tracking branch and switches to it

(git switch --track origin/feature → local feature tracking origin/feature); the branch then moves into the local group.

  • Clicking a local branch switches the work tree (git switch); a blocked switch —

typically uncommitted changes that would be overwritten — pops a toast with git's own message.

Verify

dsh --profile <name> --dump-config | Select-String ui-git-branch

The composed config shows the ui-git-branch row, and $DSH_HOME/profiles/<name>/package.json lists @dsh-mixxed/dsh-client-ui-git-branch under dsh.profile.bundles (auto-appended by dsh plugin add).

After the restart, the composer shows the branch chip; opening it reveals the grouped list, the search box, and the New branch action.

Development

pnpm run typecheck   # strict tsc over src + tests
pnpm test            # vitest: host logic (fake runner) + real-git integration + jsdom component tests
pnpm run build       # esbuild dual output → lib/index.js (node ESM) + lib/client.js (browser CJS closure)

Test profile used during development: git-branch-dev (independent of the user's web profile), booted with dsh --profile git-branch-dev --port 3800.

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category