Shyboy0499/dsh-git-tools

Local git tools for DeepSeek Harness (dsh).

dsh-git-tools is a dependency-free DeepSeek Harness plugin that gives the coding agent four local git tools — git_status, git_diff, git_log, and git_commit — so it can inspect the repo in the session workspace and create commits, all through the official tool API. No UI, Host-side only.

Features

Tool	What it does
git_status	Branch, ahead/behind, and staged / unstaged / untracked files
git_diff	Stat summary or full patch, staged or unstaged, optional path filter
git_log	Recent commits as { hash, author, date, subject }
git_commit	Stage specific paths (or all) and commit with a required message

Installation

dsh plugin --profile web add dsh-git-tools

Requires git on your PATH (present in any development environment).

Tool reference

All tools accept an optional cwd (defaults to the session workspace).

git_status

Inspect the working tree and branch state.

{
  "branch": "main",
  "ahead": 0,
  "behind": 2,
  "staged": [{ "path": "src/index.ts", "status": "M" }],
  "unstaged": [],
  "untracked": ["scratch.txt"]
}

git_diff

View changes. staged diffs the index, statOnly: true (default) returns a stat summary, statOnly: false returns the full patch. path filters to a single file.

{
  "stat": [{ "file": "src/index.ts", "added": 3, "deleted": 1 }],
  "total": { "files": 1, "insertions": 3, "deletions": 1 },
  "patch": null
}

git_log

List recent commits. count defaults to 10 (max 100); path filters to a file.

{
  "commits": [
    {
      "hash": "a1b2c3d4e5f67890abcdef1234567890abcdef12",
      "author": "Shyboy0499",
      "date": "2026-08-26",
      "subject": "Fix typo"
    }
  ],
  "total": 1
}

git_commit

Create a commit. message is required (non-empty). Stage specific files with paths, or everything with all: true. Never stages implicitly.

{
  "success": true,
  "hash": "e5f6g7h0123456789abcdef0123456789abcdef01",
  "branch": "main",
  "filesStaged": 2
}

Safety

• All git calls run through execFile with arguments passed as arrays — no shell interpolation, so user/model-controlled values are injection-safe.
• git_commit requires an explicit message and never stages files on its own (pass paths or all: true).
• No destructive operations (--amend, --force, rebase, reset) in the core scope.

Development

pnpm install
pnpm run build        # tsdown → lib/
pnpm test             # vitest against real throwaway git repos
pnpm run lint         # oxlint
pnpm run format       # prettier --write .

License

MIT