dsh-git-status-pill
A floating git status pill for DeepSeek Harness. It shows, live, for the
session's repository:
- the branch and repository name
- +/− line changes (
git diff HEAD --shortstat)
- changed-file and untracked-file counts, upstream, and ahead/behind
- a Create PR prompt: an editable title, the generated
gh pr create
command, and a ready-to-send agent prompt
It renders into the harness shell.overlay slot — the frame-wide, click-through
floating layer — so it sits above every column without blocking the app. Drag it
by the grip handle; hide it with ✕.
Install
# from a registry
dsh plugin --profile web add dsh-git-status-pill
# or straight from a checkout / tarball
dsh plugin --profile web add /absolute/path/to/dsh-git-status-pill
dsh plugin … add forwards to pnpm inside the profile directory, so the
package lands in the profile's node_modules.
Then make sure the package is in the profile's dsh.profile.bundles list in
$DSH_HOME/profiles/web/package.json:
{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-git-status-pill"]
}
}
}
That list is what applies this package's cordis.patch.yml, which inserts the
host row:
- insert:
- id: git-status-pill
name: dsh-git-status-pill
Restart the web profile. The pill appears at the bottom-right of the frame.
Publish
npm login
npm publish --access public
publishConfig/access is not set in package.json because the package is
unscoped; add "publishConfig": { "access": "public" } if you rename it under a
scope. Before publishing, set the real repository.url in package.json.
How it is wired
| Half | File | Mechanism |
|---|
| Host | lib/index.js | ESM Cordis plugin. inject: ['webServer'], registers one exact HTTP route, reads git through the ctx.shell service. |
| Client | lib/client.js | window.__ModuleLoader__ bundle. Injects slots, claims shell.overlay, polls the host route with fetch. |
| Composition | cordis.patch.yml | Inserts the host row when the bundle is applied. |
Why an HTTP route instead of a typert Remote
The canonical host→client bridge in the harness is a typert Remote
namespace — the client calls ctx.remote.<namespace>.<method>(), the host
declares @Remote(...) methods, and a plugin's client half mounts its own
descriptor with await ctx.remote.$mount(contribution). That is how shipped
plugins and community plugins like dsh-cost-meter do it.
The catch is that the descriptors on both sides
(lib/typert.host.js and the client contribution) are generated by
@deepseek-ai/dsh-typert-generator from a Host FaceModel. That generator is not
part of an installed harness (0.1.5-rc.1), and hand-writing generated schema
descriptors is brittle.
Since the harness web server is a public service, this plugin uses a plain
exact-path HTTP route instead: no codegen, no build step, plain JavaScript on
both sides. The tradeoff is that it does not participate in typert's scope and
schema validation. If you later want the first-class transport, port the route
in lib/index.js to a TypertRemoteService subclass and run the generator.
Configuration
Both the route path and the poll interval are constants at the top of the
relevant file. The route must be unique across the composition — a duplicate
(kind, path) throws at registration.
| Constant | File | Default |
|---|
ROUTE | lib/index.js, lib/client.js | /git-status-pill/status |
POLL_MS | lib/client.js | 4000 |
DEFAULT_POS | lib/client.js | bottom-right, above the composer |
Behaviour notes
- Non-repository workspaces. When the session workspace is not a checkout,
the pill scans the workspace and its parent for
.git directories and offers
them as chips, plus a field for an absolute path. A downward-only scan misses
sibling repositories, which is why the parent is included.
- Sandbox. Reads outside the session workspace can be refused by the
harness sandbox. A refusal is reported in the payload (
denied: true) rather
than silently rendered as zeros.
gh. The host reports whether gh is on PATH; without it the panel
says so and points at the agent prompt.- Clipboard. Uses
navigator.clipboard and falls back to a selectable
textarea.
Status
The widget logic is verified against real repositories. The package
packaging — module-loader wrapper, cordis.patch.yml, and the HTTP route —
has not yet been installed into a profile and booted end-to-end. Treat 0.1.0
as a first cut: install it, restart, and check the run card / browser console.
License
MIT
