Apache-2.0 工作流层，为 Claude Code、Gemini CLI、Grok、Cursor、Codex CLI 提供技能、项目知识库、交付验收与可恢复状态；README 未提及任何 DeepSeek Harness（dsh）集成。
DSH 适配
生态相关
作者声明
安全审计
未审计
最后核验
2026-08-21
许可证
Apache-2.0
01它能帮你完成什么？
Make an AI coding CLI plan, implement, and verify work to delivery instead of stopping at advice
Structured workflow stages with plan packages (requirements.md, plan.md, tasks.md, contract.json), 14 stage-specific quality skills, and delivery evidence recorded in session artifacts
Developers using Claude Code, Gemini CLI, Grok Build, Cursor, or Codex CLI who want the agent to keep working until a task is built, tested, and verified
Keep persistent project knowledge and resumable execution state across CLI sessions
A `.helloagents/` knowledge base (context.md, guidelines.md, verify.yaml, modules/, plans/) plus per-workspace session STATE.md snapshots that make long tasks resumable
Teams running long multi-session coding tasks who do not want to re-explain the repo or lose plan context between sessions
02如何接入 DeepSeek Harness？
前置条件
- Node.js >= 18 (per the README's node badge)
- npm — on npm 11 and later, keep `--allow-scripts=helloagents` on direct install or upgrade commands
- One of the supported host AI coding CLIs: Claude Code, Gemini CLI, Grok Build, Cursor, or Codex CLI
安装步骤
- 01
Install the package globally: `npm install -g --allow-scripts=helloagents helloagents` (use the `helloagents-js` alias if another `helloagents` executable already exists in PATH)
$ npm install -g --allow-scripts=helloagents helloagents
- 02
Deploy to a host CLI: `helloagents install codex --standby` for selected projects, or `helloagents install --all --global` for full rules everywhere
- 03
Restart the target AI CLI or open a new session — already running sessions do not reload injected rules automatically
- 04
Inside the AI CLI chat, run `~init` to initialize the project workflow and sync the project knowledge base
验证接入成功
- Type `~help` in the AI CLI chat — you should see the available chat commands and the current settings
回滚
- Run `helloagents cleanup <target>` to remove managed injections and links (e.g. `helloagents cleanup claude --global`)
- Run `npm explore -g helloagents -- npm run uninstall -- --all` before `npm uninstall -g helloagents` so host integrations are cleaned; project `.helloagents/` files and `~/.helloagents/helloagents.json` are intentionally preserved
03DSH 适配与能力边界
Workflow layer for AI coding CLIs (Claude Code, Gemini CLI, Grok Build, Cursor, Codex CLI); the README documents no DeepSeek Harness / dsh integration, so this is an ecosystem tool rather than a DSH plugin
14 stage-specific workflow skills
coding tasks of any stage (UI, API, security, tests, data, architecture, debugging, docs…)→task-appropriate quality rules loaded on demand — simple tasks stay light, complex work gets stricter checks
Chat commands for every work style
`~ask`, `~auto`, `~plan`, `~build`, `~prd`, `~loop`, `~init`, `~test`, `~qa`, `~commit`, `~clean`, `~help` typed in the host CLI chat→routed workflow stages — clarification, planning, implementation, QA loop, commit and closeout
most commands write plan, knowledge, and state files under `.helloagents/`; only `~ask` is pure conversation with no files createdSafer host-CLI lifecycle management
`helloagents install / update / cleanup / uninstall / doctor / switch-branch` shell commands→managed config writes to the selected host CLI, drift diagnostics, and scoped cleanup
writes and updates host config files — e.g. `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `~/.codex/AGENTS.md`, `~/.codex/config.toml`, `~/.codex/hooks.json` — plus symlinks back to the `~/.helloagents/helloagents` runtime rootthe one-shot install scripts download and execute a remote shell/PowerShell script from raw.githubusercontent.comVerification and delivery evidence
the `~qa` quality loop and delivery gates at closeout→structured receipts in session `artifacts/` (qa-review.json, advisor.json, visual.json, closeout.json) proving review, verification commands, and closeout
writes session state and evidence files under `.helloagents/sessions/`; standard runtime evidence expires after 72 hourswhen `auto_commit_enabled` is true, closeout auto-creates a local commit if verification passed and the working tree changed
04适合谁？何时不该用？
适合
- Developers using Claude Code, Gemini CLI, Grok Build, Cursor, or Codex CLI who want the agent to keep working until a task is built, tested, and verified
- Teams running long multi-session coding tasks who do not want to re-explain the repo or lose plan context between sessions
不适合
- The README documents integrations only for Claude Code, Gemini CLI, Grok Build, Cursor, and Codex CLI — DeepSeek Harness (dsh) is not among the supported host CLIs.
- Standby mode writes into the host CLI's own config files (e.g. `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `~/.codex/config.toml`, `~/.codex/hooks.json`), so installing or cleaning up affects the host CLI globally; `helloagents doctor` exists to detect drift.
05兼容性、维护与安全提示
- The README documents integrations only for Claude Code, Gemini CLI, Grok Build, Cursor, and Codex CLI — DeepSeek Harness (dsh) is not among the supported host CLIs.
- Standby mode writes into the host CLI's own config files (e.g. `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `~/.codex/config.toml`, `~/.codex/hooks.json`), so installing or cleaning up affects the host CLI globally; `helloagents doctor` exists to detect drift.
- Requires Node.js >= 18 and npm; on npm 11+ direct installs and upgrades must keep the `--allow-scripts=helloagents` flag so the managed postinstall can run. Inferred: the latest published release is a beta tag (v4.0.5-beta.1) while the README documents v3.1.9, so release lines may drift.
Apache-2.0 · actively maintained (last push 2026-08-14, latest release v4.0.5-beta.1)
06常见问题
HelloAGENTS 能接入 DeepSeek Harness（dsh）吗？
README 没有提及任何 DeepSeek Harness 集成。它支持的宿主 CLI 是 Claude Code、Gemini CLI、Grok Build、Cursor 和 Codex CLI，通过 `helloagents install` 以 standby 或 global 模式部署。
如何安装 HelloAGENTS？
先执行 `npm install -g --allow-scripts=helloagents helloagents`（需 Node >= 18；npm 11 及以上请保留 --allow-scripts 参数），再用 `helloagents install codex --standby` 部署到指定 CLI，或 `helloagents install --all --global` 全局启用完整规则。安装后重启目标 CLI 或开新会话。
怎么确认安装成功？
在 AI CLI 聊天里输入 `~help`，应能看到可用聊天命令和当前设置；然后在仓库里运行 `~init` 初始化项目工作流并同步知识库。宿主文件出现漂移时可用 `helloagents doctor` 诊断。
它会写哪些文件？
项目知识、计划与会话状态保存在项目内 `.helloagents/` 目录，用户级配置在 `~/.helloagents/helloagents.json`。standby 模式还会向宿主 CLI 的配置文件写入受管内容（如 `~/.claude/CLAUDE.md`、`~/.codex/config.toml`），cleanup/uninstall 只移除这些受管条目。
standby 和 global 模式有什么区别？
standby 更轻量、显式激活：只把规则部署到选定 CLI，仓库在运行 `~init` 之前保持未初始化状态。global 则在宿主层面应用完整规则，Claude、Gemini、Grok、Cursor、Codex 分别走原生插件 / 扩展 / 市场安装路径。
07相关的 DSH 工作流
dsh-plugin-radar
作者 adamplatin123
DSH Plugin Radar — 开源可自部署的 DSH 插件生态雷达：自动发现 15900+ 候选、k8s 运行级实测管线；自动索引可用Plugin List
picgo-core
作者 picgo
强大的图片上传引擎，同时支持 CLI 与 API。
dsh-purge
作者 yujunzhixue
DeepSeek Harness 破甲：让所有模型都能破甲，不同模型可换不同提示词；默认提示词面向国模「小码酱」。Jailbreak for every model — swap prompts per model. 求 Star 收藏 ⭐
k8e
作者 xiaods
开源的 Agentic AI 沙箱矩阵，基于 Kubernetes 的沙箱实验场。
08数据与来源
HelloAGENTS adds a workflow layer on top of Claude Code, Gemini CLI, Grok Build, Cursor, and Codex CLI.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-21。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。