Skip to content

[Agents] Add the Container harness - #34742

Draft
mattzcarey wants to merge 3 commits into
productionfrom
docs/agents-container-harness
Draft

mattzcarey wants to merge 3 commits into
productionfrom
docs/agents-container-harness

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

Adds docs for the experimental ContainerHarness (agents/harness/container): an overview page and an API reference under /agents/harnesses/container/, linked from the harnesses index and the sandbox page.

ContainerHarness shipped in agents 0.27.0 (cloudflare/agents#2514) but had no Cloudflare docs. It runs Claude Code or Codex in a Container and drives them from a Durable Object, which keeps the session and the credentials.

flowchart LR
    subgraph object["Durable Object"]
        harness["ContainerHarness"] <--> sqlite[("session, operations, CLI session files")]
    end
    harness <--> daemon
    subgraph container["Container"]
        daemon["daemon"] --> cli["Claude Code / Codex"]
    end
    cli -->|placeholder key| egress["ContainerEgress"] -->|real credentials| upstream["AI Gateway / provider"]
Loading

The "where the pieces of a harness live" concept moved to the Harness concept page in #33975, so merge that first; these pages link to it.

pnpm run check, the full build and lint:nimbus passed before the concept page moved out.

@github-actions github-actions Bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Oct 29, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-agents-container-harness.previews.developers.cloudflare.com (commit 740de37)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://faaaf5fe.previews.developers.cloudflare.com 740de37 2026-10-29T18:18:45.999Z Visit the dashboard ↗
  • Build: In progress 🔵

View logs ↗
9b561ad 2026-10-29T18:09:50.927Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://c4334e33.previews.developers.cloudflare.com 3523895 2026-10-29T18:04:25.743Z Visit the dashboard ↗

@mattzcarey mattzcarey changed the title [Agents] Add the Container harness and a brains and hands concept page [Agents] Add the Container harness Oct 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

CI run failed: build logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant