# Ze Harness

> Ze is an agent harness: one Harness core runs Sessions, the model and tool loop, plugins, and a Linux workspace, from the `ze-harness` CLI, an embedded SDK, a Node.js server, or a Cloudflare Worker.

ze.dev runs a live Ze terminal in the browser. Each page below is Markdown; the same path without
`.md` is the HTML page.

## Docs

- [harness-cli](/docs/cli.md): The `ze-harness` command-line client and its embedded-or-remote composition edge.
- [harness-client](/docs/client.md): Typed Effect Client for the Ze Harness v1 protocol.
- [harness-codemode](/docs/codemode.md): Run JavaScript that combines tools and returns selected results.
- [Configuration file](/docs/config.md): The Node host (the `ze-harness` CLI, the SDK, and the Node.js server) reads a global `config.json` and the nearest project `ze-harness.config.json`.
- [harness](/docs/harness.md): The platform-neutral Ze Harness Core.
- [HTTP API](/docs/http-api.md): Typed HTTP API for durable agent Sessions and Turns.
- [harness-llm](/docs/llm.md): Portable Effect Schema and Stream contracts for one provider model attempt.
- [harness-plugin](/docs/plugin.md): Authoring contracts for trusted Ze Harness plugins.
- [harness-protocol](/docs/protocol.md): The validated, versioned HTTP and SSE contract shared by the Server and Client.
- [harness-schema](/docs/schema.md): Shared Effect schemas and TypeScript types for Ze Harness domain, persistence, and wire values.
- [harness-sdk](/docs/sdk.md): The embedded Node.js composition for Ze Harness.
- [harness-server](/docs/server.md): Runtime-neutral Fetch HTTP handling for Ze Harness.
- [harness-server-node](/docs/server-node.md): Node.js hosting for Ze Harness, including filesystem config discovery and trusted plugin loading.
- [harness-storage-durable-object](/docs/storage-durable-object.md): Cloudflare Durable Object SQLite adapter for the Core-owned Harness `StorageService`.
- [harness-storage-sqlite](/docs/storage-sqlite.md): The Node SQLite adapter for Core's `Storage` service.
- [harness-worker](/docs/worker.md): Cloudflare Worker composition for Ze Harness.
- [harness-worker-host](/docs/worker-host.md): The embeddable Harness host for Durable Objects.

## Machine-readable contracts

- [OpenAPI document](/openapi.json): the Harness HTTP API as OpenAPI 3.1, with every request and response schema.
- [Configuration JSON Schema](/ze-harness.config.schema.json): the `ze-harness.config.json` format as JSON Schema (draft 2020-12).
- [Plugin declarations](/harness-plugin.d.ts): every public type of `@zephyrcloudio/harness-plugin`, the plugin authoring contract, with its documentation.

## Optional

- [Full documentation](/llms-full.txt): every page above in one file.