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-toolsRequires 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
execFilewith arguments passed as arrays — no shell
interpolation, so user/model-controlled values are injection-safe.
git_commitrequires an explicitmessageand 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 .