Skip to content

dsh-github 0.2.1

Choose a tag to compare

@ban-sky ban-sky released this 08 Nov 07:16
· 18 commits to main since this release

dsh-github 0.2.1

GitHub integration for DSH (DeepSeek Harness): official device-flow sign-in, repository management, and in-session folder operations — security first.

Highlights

  • Session folder actions (0.2.0) — the GitHub button above the composer clones, creates + publishes, pulls, fetches and commits inside the current session's working directory. The client only sends a sessionId; the Host resolves the directory from the session itself, so a browser can never point the plugin at an arbitrary path.
  • Mobile pill fix (0.2.1) — the composer button collapses to a 26px branch icon at ≤640px, so a narrow composer can no longer squeeze the "GitHub" label into a vertical column. The icon keeps its aria-label.
  • Expired-token UX (0.2.1) — the dock now shows the sign-in hint instead of action buttons when the stored token has expired.
  • Settings page — sign in with GitHub, list/create/clone repositories, inspect local clones, pull, commit, push, and toggle the optional agent tool.

Security model

  • The access token is stored only in the DSH credential store ($DSH_HOME/.credentials.yaml, mode 0600). It never appears in plugin config, argv, .git/config, or remote URLs.
  • Git receives the token through the child environment and an inline ! credential helper; nothing is written to disk.
  • Repo names, owners, local paths and remotes are validated host-side; clones must stay inside the configured clone root and only https://github.com/owner/name remotes are accepted.
  • Every error is redacted before it reaches the UI.
  • Local-only reads (status, log) run without the token at all.

Install

  1. Download dsh-github-0.2.1.tgz from this release.
  2. Extract it: tar -xzf dsh-github-0.2.1.tgz (produces a package/ folder).
  3. Install the bundle from that folder: plugin_manager install_bundle target:/path/to/package (or point the DSH plugin installer at the extracted folder).
  4. Reload the Web UI. A GitHub section appears in Settings.

Get started

  1. GitHub → Settings → Developer settings → OAuth Apps → New OAuth App, and enable Device flow.
  2. Paste the OAuth App Client ID into Settings → GitHub and save.
  3. Click Sign in with GitHub, then enter the shown code at https://github.com/login/device.

If the OAuth App has "Expire user authorization tokens" enabled the token lasts 8 hours; disable it for a long-lived token (this version does not refresh tokens yet).

See README.md / README.zh.md for the full manual, permission scope (repo), and limitations.