dsh-git-nexus

dsh-git-nexus

A single, self-contained DeepSeek Harness (DSH) web plugin that merges the
git-management features of the popular dsh-web-ui plugin (SCM change panel +
branch management) with GitHub access, a workflow board, and file browsing —
one panel instead of several plugins.

Features

• Changes (SCM) — working-tree status, per-file diff, stage / unstage / discard, commit.
• Branches — list, switch, create, delete.
• Remote — push, pull, sync (pull then push), fetch.
• Log — bounded, structured commit history.
• Files — list tracked files with search, read any text file.
• Workflow — persistent step board (Claude Code-style plan tracking).
• GitHub — OAuth Device Flow login (full repo access, revocable), scope seal, PR creation.

Install

dsh plugin --profile web add "file:/absolute/path/to/dsh-git-nexus"
# then restart the web profile
dsh web

The plugin appears under Settings → Plugins and the panel pill appears in
the session header of git-managed workspaces.

Compatibility

Targets DSH 0.1.0-rc.6 (web profile). The plugin ships a strict
Typert host manifest
(./typert) and mounts strict client codecs, matching the conventions of the
plugins inside the official repository.

This is a community plugin published under the dsh-plugin
topic — the channel the DeepSeek Harness
maintainers ask community extensions to use (see the project's
CONTRIBUTING.md).

GitHub OAuth

GitHub auth uses the device flow,
so no long-lived PAT is written to disk. You need a GitHub OAuth App client id:

1. Go to GitHub → Settings → Developer settings → OAuth Apps → New OAuth App.
2. Any name / homepage / callback will do (device flow ignores the callback).
3. Paste the resulting Client ID into the panel's GitHub tab, click Connect,
   then open the printed URL and enter the user code.

The resulting token requests the repo, workflow, read:user and user:email
scopes and is stored with 0600 permissions under
~/.dsh/storages/dsh-git-nexus/. If the gh CLI is already authenticated, the
plugin uses it automatically and no client id is required.

Security notes

• Every git/file command runs through a fresh /bin/sh -c child process with a
  30s timeout and a 2 MiB output cap. The web profile scopes DSH's shell
  service to per-session agent realms, so the host-plane gateway executes
  directly instead of injecting it.
• Branch names, paths, and commit messages are shell-quoted; control characters are rejected.
• GitHub tokens live only under ~/.dsh/storages/dsh-git-nexus/settings.json (mode 0600).

License

MIT