The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
docs: put the ask above the explanation
deehwc4dac89e97b9
diff --git a/README.md b/README.mdindex de575362f..af0e85e16 100644--- a/README.md+++ b/README.md@@ -38,49 +38,9 @@ It drives the agents you already use — and if yours isn't here,<img src=".github/assets/engines/muse.png" height="72" alt="Muse Code" title="Muse Code"></p>-## How it works--Your agents stay your processes, on your hardware, with your credentials. Harness watches them and-gives you one place to steer from.--```- Harness (the device)- │- ╔═════════╧═════════╗- ║ Autonomous relay ║ end-to-end encrypted · we hold no keys- ╚═════════╤═════════╝- ┌───────────────────────┼───────────────────────┐- │ │ │- your laptop your server your platform- `harness join` `harness join` your HTTP API- │ │ │- claude · codex hermes · muse agents running on- cursor · … opencode · … your own servers-- └───────── CLI ─────────┘ └─────── API ───────┘-```--Everything is encrypted on your machine before it reaches us — Ed25519 identities pinned at pairing,-X25519 per connection, ChaCha20-Poly1305 per frame. The relay moves ciphertext and holds no key-material. Read it yourself: [`cli/src/lib/e2ee/`](cli/src/lib/e2ee/).--## Get started--You need **Node.js 20 or newer** and **tmux**. Make a machine in the web app, copy its token, then run-this on any computer you want your agents driven from — laptop, server, cloud VM:--```bash-curl -fsSL https://harness.autonomous.ai/install.sh | bash -s -- <token>-harness join # connect this computer-harness status # running? shows the chat link-```--Start `claude`, `codex`, `cursor` or any supported agent in a tmux pane and it shows up as something-you can talk to from the browser and from the device. Every command: [`cli/README.md`](cli/README.md).-## Add your agent to Harness-Yours not in that list? Put it there. Two ways in, and one question tells you which: **is your agent a+Yours not in that row? Put it there. Two ways in, and one question tells you which: **is your agent acommand someone runs, or a service they call?**| | **CLI** | **API** |@@ -90,8 +50,7 @@ command someone runs, or a service they call?**| **You ship it** | as a pull request to this repo | by deploying it yourself || **Start at** | [`cli/src/engines/`](cli/src/engines/README.md) | [`provider/`](provider/README.md) |-Run `harness join` on any machine you can reach and its agents show up next to your laptop's. In the-code these are named `engine` (CLI) and `provider` (API) — the folder names you'll see.+In the code these are named `engine` (CLI) and `provider` (API) — the folder names you'll see.```bash# CLI — typecheck and replay the recorded-session fixtures@@ -105,6 +64,43 @@ npm run conformance -- --url https://your-endpoint --key <credential>Both guides are written so you can do it without talking to us first. If you get stuck, that's a bugin the guide — tell us.+## Get started++Node.js 20+ and tmux. Make a machine in the web app, copy its token:++```bash+curl -fsSL https://harness.autonomous.ai/install.sh | bash -s -- <token>+harness join+```++Start `claude`, `codex` or any supported agent in a tmux pane and it shows up in the browser and on+the device. Every command: [`cli/README.md`](cli/README.md).++## How it works++Your agents stay your processes, on your hardware, with your credentials.++```+ Harness (the device)+ │+ ╔═════════╧═════════╗+ ║ Autonomous relay ║ end-to-end encrypted · we hold no keys+ ╚═════════╤═════════╝+ ┌───────────────────────┼───────────────────────┐+ │ │ │+ your laptop your server your platform+ `harness join` `harness join` your HTTP API+ │ │ │+ claude · codex hermes · muse agents running on+ cursor · … opencode · … your own servers++ └───────── CLI ─────────┘ └─────── API ───────┘+```++Everything is encrypted on your machine before it reaches us — Ed25519 identities pinned at pairing,+X25519 per connection, ChaCha20-Poly1305 per frame. The relay moves ciphertext and holds no key+material. Read it yourself: [`cli/src/lib/e2ee/`](cli/src/lib/e2ee/).+## Contributing, security, licence- Adding an agent, or a gap in the spec — [CONTRIBUTING.md](CONTRIBUTING.md).