Which git hosts does dsh-zgit support?

GitHub, GitLab (API v4, nested groups) and Gitee (API v5), plus generic GitHub-style self-hosted hosts (Gitea, GitHub Enterprise) for archive/raw URL guessing.

How do I install dsh-zgit?

Run: dsh plugin --profile web add dsh-zgit (the package is published on npm as dsh-zgit). A Git install works too: dsh plugin --profile web add github:zukunftsholz/dsh-zgit

dsh-zgit

Name: dsh-zgit
Author: zukunftsholz

Zero-git source & release fetcher for DeepSeek Harness

GitHub repo Releases Issues 中文文档

Install

dsh plugin --profile web add dsh-zgit

What is dsh-zgit?

dsh-zgit (the /zgit plugin) is a DeepSeek Harness (dsh) plugin for when the first thought about fetching source code or binary releases from a git host should not be git clone.

It fetches over plain HTTPS, with no git binary and zero runtime dependencies:

Source code → downloaded as a forge archive (codeload-style tar.gz/zip), extracted into a simulated checkout with .zerogit metadata you can inspect, status-check and refresh.
Binary releases → release assets listed or downloaded from GitHub / GitLab / Gitee releases, with sha256 verification against shipped checksum files.
git, simulated → zgit_ls_remote, zgit_show, zgit_ls_tree, zgit_log, zgit_diff, zgit_status reimplement the read side of git over the forge APIs.
Anything else → zgit_download fetches any direct URL into the workspace, with a byte cap and optional sha256.

Tools

Tool	git analog	What it does
`zgit_ls_remote`	`git ls-remote`	Branches, tags, ref→sha resolution, default branch, latest release tag.
`zgit_clone`	`git clone` / `git archive`	Downloads the source archive at a ref, extracts it as a simulated checkout (`.zerogit/meta.json`); supports `subdir` sparse extraction and explicit archive URLs.
`zgit_fetch_release`	`gh release download`	Lists or downloads release assets (latest or a tag) with glob patterns and sha256 verification.
`zgit_show`	`git show`	Fetches one raw file at a ref.
`zgit_ls_tree`	`git ls-tree`	Lists files/dirs at a ref via the forge API.
`zgit_log`	`git log`	Recent commits at a ref.
`zgit_diff`	`git diff`	Compare two refs: changed-files summary or a single-file unified diff.
`zgit_status`	`git status` + `git fetch`	Checks a simulated checkout against the remote: moved ref, commits behind.
`zgit_download`	`curl`	Any direct HTTPS download into the workspace, capped, with optional sha256.

Plus the human-plane command /zgit (Web UI slash menu / TUI): clone, get, show, ls, log, diff, resolve, status, download — the same operations without the model in the loop.

Forge support

GitHub — github.com + api.github.com + codeload.github.com + raw.githubusercontent.com
GitLab — gitlab.com + API v4, including nested groups
Gitee — gitee.com + API v5
Generic GitHub-style hosts (Gitea, GitHub Enterprise) — archive/raw URL guessing works; API-backed operations report a clear error, falling back to archiveUrl or zgit_download

Repo references accept owner/repo, owner/repo@ref, full https:// URLs, git@host:owner/repo.git, and ssh:// URLs.

FAQ

What is dsh-zgit?

dsh-zgit (zgit) is a DeepSeek Harness plugin that fetches source archives and release assets from git hosts over plain HTTPS. It needs no git binary and adds no runtime dependencies.

Do I need git installed?

No. Everything runs over HTTPS against the forge's archive, raw-file and release endpoints.

Which git hosts are supported?

GitHub, GitLab (API v4, nested groups) and Gitee (API v5). Generic GitHub-style self-hosted hosts (Gitea, GitHub Enterprise) work for archive/raw URL guessing.

How do I install it?

dsh plugin --profile web add dsh-zgit — the package is on npm. The Git form github:zukunftsholz/dsh-zgit and a local checkout (./dsh-zgit) work too.

Is it a git replacement?

It reimplements the read side of git (ls-remote, show, ls-tree, log, diff, status) over the forge APIs, plus release-asset download. It does not do writes or pushes.

Are downloads verified?

Release assets and zgit_download support sha256 verification against shipped checksum files. Zip entries are CRC32-verified; gzip is decompressed under a hard cap (bomb guard).

Which DSH version does it target?

DSH 0.1.5-rc.2 (cordis 4.0.2, schemastery 3.18.2).

What license is dsh-zgit?

MIT.

中文简介

dsh-zgit（/zgit 插件）是一个 DeepSeek Harness（dsh）插件：当需要从 git 仓库拉取源代码或二进制发行版时，第一想法不再是 git clone，而是更敏捷的纯 HTTPS 方案。它无需 git 二进制、零运行时依赖。

安装：

dsh plugin --profile web add dsh-zgit

源代码 → 下载代码托管平台的源码归档（codeload 风格 tar.gz/zip），解压成带 .zerogit 元数据的模拟检出目录。
二进制发行版 → 从 GitHub / GitLab / Gitee 的 Releases 列出或下载产物，支持 sha256 校验。
模拟 git → zgit_ls_remote、zgit_show、zgit_ls_tree、zgit_log、zgit_diff、zgit_status 用平台 API 重新实现 git 的"读"侧。
其他 → zgit_download 下载任意直链进工作区，带字节上限与可选 sha256。

支持 GitHub、GitLab（API v4，含嵌套分组）、Gitee（API v5），以及通用 GitHub 风格自建主机。完整说明见 README.zh.md。