Show and tell: run auditable agent sessions locally with SandBase Harness

[liyangbing]

SandBase Harness is a local-first runtime for agent sessions that need more than a chat transcript: persistent session state, explicit approval gates, sandboxed execution, artifacts, audit events, and replay.

Quick start:

git clone https://github.com/sandbaseai/sandbase-harness.git
cd sandbase-harness
npm install
npm run dev

For MCP clients, use the published bridge image:

docker run -i --rm \
  -e MANAGED_AGENTS_URL=http://host.docker.internal:3000 \
  ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8

The installation guide includes Claude Code, Cursor, Cline, OpenCode, DeepSeek Harness, and other client examples: https://github.com/sandbaseai/sandbase-harness/blob/main/llms-install.md

欢迎分享你的运行环境、sandbox 后端选择，以及你希望审计/回放的 agent 工作流。

[liyangbing]

客户端配置示例（本地 runtime 在宿主机 3000 端口）：

{
  "mcpServers": {
    "sandbase-harness": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MANAGED_AGENTS_URL", "ghcr.io/sandbaseai/sandbase-harness-mcp:0.3.8"],
      "env": {"MANAGED_AGENTS_URL": "http://host.docker.internal:3000"}
    }
  }
}

如果 runtime 开启 bearer-token 认证，再增加 MANAGED_AGENTS_API_KEY，不要把真实密钥提交到配置仓库。完整说明见 llms-install.md。

[liyangbing]

安全生态进展：已向 Agent Sandbox Taxonomy 提交 SandBase Harness 档案提案。提案刻意不预设分数，邀请维护者根据不同 backend（local/Docker/Kubernetes/self-hosted worker）分别核验 L1–L7，尤其是凭证边界、审批治理和审计/回放能力。欢迎大家在 Issue 或本讨论中指出不准确之处。

[liyangbing]

Sandbox 生态进展：新增 Mossaka/awesome-agent-sandboxes PR #1，将 SandBase Harness 提交到 Agent-Native Sandbox Platforms / Open Source 分类。该 PR 已补充 v0.3.8、Apache-2.0、安装文档，以及 local/Docker/Kubernetes/self-hosted worker 的 backend 边界说明；当前仍等待维护者审核。

[liyangbing]

推广进展更新（2026-08-31）：

• mcpHQ/awesome-mcp-servers PR #45 已合并，SandBase Harness 已在公开 README 中与 SandBase CLI 分开列出；对方的 validate、generate、check-generated 均通过。
• 新发现 DSH Plugin Store 已公开展示项目条目。该页面可能存在旧版本快照，安装和版本信息请以 官方仓库 与 v0.3.8 release 为准。

如果你在使用这些目录入口，欢迎反馈条目描述、安装路径或版本信息是否需要修正。

[liyangbing]

推广跟进（2026-08-31）：

上一轮向 msyvr/awesome-agent-sandboxes 提交候选后，已形成正式 PR #58。该 PR 将 Harness 收录为 abstraction-layer runtime，并重新生成目录数据、README、参考文档和图表；作者报告 148 个测试通过。我们已补充说明：实际隔离能力由 local、Docker、Kubernetes 或 self-hosted worker 后端及部署配置决定，不宣称固定 microVM 隔离。

[liyangbing]

新增公开收录：

MCP Server Hub — SandBase Harness 已上线并返回 HTTP 200。页面展示官方 GitHub 仓库及 SandBase Harness 的 MCP/runtime 描述，适合作为新的发现入口；安装、版本和安全边界仍以本仓库与 v0.3.8 release 为准。

[liyangbing]

新增下游镜像核验：

MCP Central API 已返回 io.github.sandbaseai/sandbase-harness:0.3.4)，状态为 active)，并指向官方 GitHub 仓库。该镜像版本快照可能滞后于当前 v0.3.8，因此安装和最新版本信息仍以官方 Registry/仓库为准。

[liyangbing]

Promotion update — registry submissions consolidated:

• Docker MCP Registry: canonical review path is PR #4841. Duplicate PR #4838 was closed; the published v0.3.8 GHCR image completed MCP initialize and tools/list with all six bridge tools.
• ToolSDK MCP Registry: canonical review path is PR feat(webhooks): screen the address a delivery resolves to #488. Registry schema and Biome checks pass, and the same v0.3.8 image verification is documented.
• TensorBlock: PR #2068 remains review-gated until its generated install metadata includes the image and environment arguments.

This keeps discovery links factual while maintainers review the canonical entries.

[liyangbing]

新的实践入口（2026-08-31）：如果你从 DeepSeek Harness 开始评估运行时，可以先看已部署的英文开发者教程或中文教程。两篇都已更新到 SandBase Harness v0.3.8，并链接当前安装文档与版本固定的集成示例。\n\n欢迎分享你的实际运行环境、sandbox backend、安装遇到的问题，以及哪些审计/回放信息对你最有用。目录收录和博客文章不代表安全认证；隔离能力仍取决于后端和部署配置。