Skip to content

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.

docs: put the ask above the explanation

deehwc4dac89e97b9
diff --git a/README.md b/README.md
index 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 a
command 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 bug
in 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).