Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
229 changes: 229 additions & 0 deletions audits/2026-06-15-docs-quality-pages.csv

Large diffs are not rendered by default.

2,410 changes: 2,410 additions & 0 deletions audits/2026-06-15-docs-quality-sections.csv

Large diffs are not rendered by default.

52,488 changes: 52,488 additions & 0 deletions audits/2026-06-15-docs-quality.json

Large diffs are not rendered by default.

459 changes: 459 additions & 0 deletions audits/2026-06-15-docs-quality.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion pages/blueprints/ai-agent-sandbox/dapp-and-indexer.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ The sandbox app is iframe-first. The parent dapp should:

## Bad copy to avoid

Do not name the product after one harness. The Sandbox SDK supports OpenCode plus 12 peer backend types: Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, and CLI base. The current Sandbox UI picker exposes a subset plus NanoClaw. The AI Agent Sandbox blueprint's current all-harness sidecar advertises Claude Code, Codex, OpenCode, Kimi Code, and Gemini CLI. The product boundary is the sandbox service instance and operator API.
Do not name the product after one harness. The Sandbox SDK supports OpenCode plus 13 peer backend types: Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, and CLI base. The current Sandbox UI picker exposes OpenClaw and NanoClaw while deferring Pi, Forge, ACP, and Cursor. The AI Agent Sandbox blueprint's current all-harness sidecar advertises Claude Code, Codex, OpenCode, Kimi Code, and Gemini CLI. The product boundary is the sandbox service instance and operator API.

Use capability language instead:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: Runtime backends, capability discovery, harnesses, and AI credentia

The sandbox is the product. Harnesses are tools inside the sandbox.

Do not describe this blueprint as an OpenCode integration, a Codex integration, or a Claude integration. The Sandbox SDK supports OpenCode plus 12 peer backend types: Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, and CLI base. A blueprint service instance asks its operator for the live runtime set through `GET /api/capabilities`.
Do not describe this blueprint as an OpenCode integration, a Codex integration, or a Claude integration. The Sandbox SDK supports OpenCode plus 13 peer backend types: Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, and CLI base. A blueprint service instance asks its operator for the live runtime set through `GET /api/capabilities`.

## Runtime backends

Expand Down
2 changes: 1 addition & 1 deletion pages/blueprints/ai-trading/operator-requirements.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Public admission means public cost exposure. Every accepted bot can use CPU, dis

The operator install path defaults new bots to paper trading. Paper mode uses live market data and simulated fills; it should not move capital.

AI keys are optional. If you set `ZAI_API_KEY`, `ANTHROPIC_API_KEY`, `TANGLE_API_KEY`, or OpenCode model/env settings, agentic activation and chat can use those settings when the selected sidecar advertises OpenCode. Treat OpenCode as one harness inside the same capability model as Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, CLI base, or a smaller blueprint sidecar subset. The operator docs are clear: there is no built-in per-bot, per-day, or total LLM spend cap today. Use provider-side billing limits.
AI keys are optional. If you set `ZAI_API_KEY`, `ANTHROPIC_API_KEY`, `TANGLE_API_KEY`, or OpenCode model/env settings, agentic activation and chat can use those settings when the selected sidecar advertises OpenCode. Treat OpenCode as one harness inside the same capability model as Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, CLI base, or a smaller blueprint sidecar subset. The operator docs are clear: there is no built-in per-bot, per-day, or total LLM spend cap today. Use provider-side billing limits.

## Public endpoint

Expand Down
2 changes: 1 addition & 1 deletion pages/blueprints/operator-matrix.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ The three first-party blueprints do not fail the same way. A sandbox operator ru

## Harnesses are not the product boundary

The sandbox product is the sandbox service instance plus its operator API. The Sandbox SDK supports OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, and CLI base. The current all-harness sidecar in the sandbox blueprint advertises Claude Code, Codex, OpenCode, Kimi Code, and Gemini CLI through `GET /api/capabilities`.
The sandbox product is the sandbox service instance plus its operator API. The Sandbox SDK supports OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, and CLI base. The current all-harness sidecar in the sandbox blueprint advertises Claude Code, Codex, OpenCode, Kimi Code, and Gemini CLI through `GET /api/capabilities`.

That endpoint is the contract the app should read. Do not make docs or UI copy pretend OpenCode, Codex, or any one harness is the integration. Harness support can change by publishing a new sidecar image without changing the blueprint ABI.

Expand Down
7 changes: 4 additions & 3 deletions pages/infrastructure/harnesses.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ There are three related surfaces:

| Surface | Source of truth | Current harness set |
| ---------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Published Sandbox SDK | `@tangle-network/sandbox` `BackendType` | OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, and CLI base. |
| Published Sandbox SDK | `@tangle-network/sandbox` `BackendType` | OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, and CLI base. |
| Current Sandbox UI picker | `sandbox-ui` harness picker | OpenCode, Claude Code, Codex, AMP, Factory Droids, Kimi Code, OpenClaw, NanoClaw, Hermes, and CLI base. The picker defers SDK backends such as Pi, Forge, ACP, and Cursor until copy and compatibility policy land. |
| AI Agent Sandbox blueprint sidecar | The operator's `/api/capabilities` response | Claude Code, Codex, OpenCode, Kimi Code, and Gemini CLI in the current `ghcr.io/tangle-network/blueprint-sidecar:all-harness` image. |

Expand All @@ -35,11 +35,12 @@ The published SDK accepts these backend types:
| Hermes | Hermes coding harness. |
| Forge | SDK backend type; not surfaced in the current Sandbox UI picker. |
| OpenClaw | Dispatcher path for Claude, Codex, and Gemini CLIs. |
| NanoClaw | Local socket-bridge agent backend. |
| ACP | Agent Client Protocol bridge for ACP-compliant agent binaries. |
| Cursor | Cursor Agent SDK backend. |
| CLI base | Shell and workflow tools without a coding harness. |

The current Sandbox UI picker also surfaces NanoClaw, a local socket-bridge agent backend, while deferring Pi, Forge, ACP, and Cursor. Product docs should say which surface they mean.
The current Sandbox UI picker exposes OpenClaw and NanoClaw while deferring Pi, Forge, ACP, and Cursor. Product docs should say which surface they mean and should prefer `/api/capabilities` for live operator surfaces.

These are execution harnesses, not routing categories. Every coding harness runs inside the sandbox. Unless a profile, user setting, or operator config points elsewhere, model calls go through Tangle Router. Do not describe routing as a property of one harness.

Expand All @@ -60,7 +61,7 @@ Read `GET /api/capabilities` before rendering a harness choice. The image tag is

Any public copy that names OpenCode must name the peer harnesses or link to this page. The correct framing is:

> The sandbox supports multiple harnesses. OpenCode is one adapter beside Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, CLI base, and blueprint sidecar images that may advertise a smaller set through `/api/capabilities`.
> The sandbox supports multiple harnesses. OpenCode is one adapter beside Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, CLI base, and blueprint sidecar images that may advertise a smaller set through `/api/capabilities`.

The wrong framing is:

Expand Down
2 changes: 1 addition & 1 deletion pages/vibe/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The workbench sends execution to the sandbox runtime. Hosted runs use product/AP

## Profiles Power The Runtime

Workbench profiles configure the selected agent harness, model routing, per-agent prompts, and tool permissions. OpenCode sits beside 12 other Sandbox SDK backend types: Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, and CLI base. Protocol-backed service instances must still read their own `/api/capabilities` response.
Workbench profiles configure the selected agent harness, model routing, per-agent prompts, and tool permissions. OpenCode sits beside 13 other Sandbox SDK backend types: Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, and CLI base. Protocol-backed service instances must still read their own `/api/capabilities` response.

## Start Here (By Role)

Expand Down
2 changes: 1 addition & 1 deletion pages/vibe/profile-schema.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This page documents the profile schema used to configure sidecar agents. The sch

## Current Support

- **Sandbox SDK backends**: OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, and CLI base.
- **Sandbox SDK backends**: OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, and CLI base.
- **Sandbox UI picker**: the current picker exposes OpenCode, Claude Code, Codex, AMP, Factory Droids, Kimi Code, OpenClaw, NanoClaw, Hermes, and CLI base while deferring Pi, Forge, ACP, and Cursor.
- **Blueprint sidecar**: the AI Agent Sandbox blueprint's current all-harness sidecar advertises Claude Code, Codex, OpenCode, Kimi Code, and Gemini CLI through `/api/capabilities`.

Expand Down
2 changes: 1 addition & 1 deletion pages/vibe/profiles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Profiles define how an agent behaves end to end. They package model choice, tool

## What A Profile Controls

- **Harness selection**: OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, ACP, Cursor, or CLI base when the product exposes them. The current Sandbox UI picker also surfaces NanoClaw and defers Pi, Forge, ACP, and Cursor until product policy lands.
- **Harness selection**: OpenCode, Claude Code, Kimi Code, Codex, AMP, Factory Droids, Pi, Hermes, Forge, OpenClaw, NanoClaw, ACP, Cursor, or CLI base when the product exposes them. The current Sandbox UI picker defers Pi, Forge, ACP, and Cursor until product policy lands.
- **Model selection**: primary and small model routing per profile.
- **Per-agent tuning**: distinct configs for plan/build/explore (prompt, temperature, max steps).
- **Tool access**: enable or disable individual tools.
Expand Down
Loading
Loading