dsh-wo-github

dsh-wo-github

A DeepSeek Harness (DSH) plugin: a GitHub subtab in the Workspace Overview tab, presenting the current workspace's repository as if you were on the site. Local first: commits, diffs, and the README come from the workspace's own clone.

Also adds a BRANCH PILL to the composer's left row (beside the persona picker): the GitHub mark plus the workspace's checked-out branch, polled live so agent checkouts update it, with an amber badge counting files with uncommitted changes. When the worktree is dirty, clicking the pill opens the GitHub tab straight on the Pending pane (clicking again closes it); clean, it links to the branch's tree. A bag icon with a count between the pill and the chevron marks stashed change sets (git stash list / stash pop). A chevron beside the pill opens the branch switcher: switch local branches or create a new one (which takes the pending changes with you). Switching with a dirty worktree asks the GitHub Desktop question: leave the changes here (stashed, recoverable with git stash) or bring them along (refused atomically by git when they would conflict on the target). Hidden outside a git repo; a detached HEAD shows the short sha.

A branch header sits above the panes: the checked-out branch with dirty/stash badges and the same switcher the composer pill has, and the pane body is keyed by branch so switching branches remounts every pane against the new checkout.

Four panes:

• Overview: the About card: description, topics, stars/watchers/

forks/issues, language, license, default branch, homepage, last push (repo name and branch paint instantly from the git remote and the branch pill's cache; fetched fields show skeletons, never a page-wide loading blank); the README renders beneath it (through dsh-md-view), with relative links and images resolved against the repo, silent when absent.

• Pending: the GitHub Desktop surface, side by side: the file list and

commit box on the left, the selected file's diff on the right, always visible together. One flat list where every file carries a three-state checkbox: check = fully staged, dash = partially staged (click unstages the file), empty = nothing staged (click stages all of it), a status dot (orange modified, green new, red deleted; tooltip carries the word), and the staged line counts (+N green, -M red, zeros hidden). The diff is ONE combined whole-file view (HEAD vs worktree) rendered through dsh-diff-view with distant regions collapsed into gap rows: one column of checkmarks per changed line (filled = already in the index; click to toggle just that line) and a second column per section (a group of contiguous lines), left of the line marks, anchored at the section's first changed line and filled when all its lines are staged; click it to stage or unstage the whole section. A file's checkbox stages or unstages everything at once. Split/Unified toggles; the commit box commits exactly what is staged. Never amends, pushes, or touches history.

• Stash: the checked-out branch's stashed changes, one row per entry

with Pop (restore into the worktree and remove the entry) and Drop (discard for good); entries from other branches are noted, not listed. Clicking the branch pill opens this pane when the worktree is clean but stashes exist (dirty always goes to Pending; clean without stashes also goes to Pending).

• History: the checked-out branch's history, newest first, paginated,

laid out like Pending: commit list on the left, the selected commit's changed files (with +/− counts) beside it, and the selected file's unified diff with true line numbers in the main area; word-level highlights come from dsh-diff-view when installed.

No git clone and no github.com remote? The tab shows a quiet empty state. A clone WITHOUT a github.com remote (gitlab, local-only git) still gets README and Commits, with branch and last-commit facts on the About pane in place of stars.

How it fetches

Local first: the host half runs git in the workspace clone:

• Commits come from git log, commit diffs from git show, the README

from the committed file (git show HEAD:README.md). No rate limits, works offline, works on any git host.

• api.github.com fills in what git cannot know (stars, watchers, issues,

topics, license) on the About card, and serves as fallback when the clone cannot answer. The page itself cannot call the API, so the host proxies it: unauthenticated access works for public repos; set GITHUB_TOKEN in the harness environment to lift the 60-requests-per-hour ceiling.

• API caching: About 5 minutes, commit lists 2 minutes, single commit

diffs forever (a sha never changes). Local reads are uncached, since git is fast and the data is live by definition.

• Rate-limit exhaustion surfaces as a clear message in the tab instead of

a broken pane.

How to install

Requires a DeepSeek Harness checkout and a profile, here web. Clone the dependencies and this plugin into a plugins folder:

mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-workspace-overview.git
git clone https://github.com/joao-paulo-santos/dsh-md-view.git
git clone https://github.com/joao-paulo-santos/dsh-diff-view.git
git clone https://github.com/joao-paulo-santos/dsh-wo-github.git

# from the harness checkout
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-workspace-overview
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-md-view
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-diff-view
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-wo-github

# verify the profile still composes
pnpm dsh --profile web --dump-config

Restart the harness; the GitHub tab appears in Workspace Overview.

Dependencies

• dsh-workspace-overview hosts the subtab and resolves the workspace's GitHub slug (required; without it the client half stays inactive)
• the git binary on PATH (local reads); api.github.com access is the fallback
• dsh-md-view renders the README pane (optional; without it the raw markdown shows as text)
• dsh-diff-view provides word highlights and the diff grid stylesheet (optional; patches still render without it)

Plugins dependent on this

*(none)*