Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

docs: recommend Hermes built-in computer use (#3274)

injaneityb25f8290e9cd
diff --git a/docs/content/docs/concepts/choose-a-cua-driver-integration.mdx b/docs/content/docs/concepts/choose-a-cua-driver-integration.mdx
index aae59d5214..e17d0d99c4 100644
--- a/docs/content/docs/concepts/choose-a-cua-driver-integration.mdx
+++ b/docs/content/docs/concepts/choose-a-cua-driver-integration.mdx
@@ -36,9 +36,11 @@ The MCP client starts `cua-driver mcp` and keeps its standard input and output
open. That authenticated transport receives a private implicit lifecycle
session. Closing the transport releases its session state.
-This is the normal route for Codex, Claude Code, Cursor, Hermes, and a standard
-OpenClaw gateway. Generate the client-specific configuration with
-`cua-driver mcp-config --client <client>`.
+This is the normal route for Codex, Claude Code, Cursor, and a standard
+OpenClaw gateway. Hermes's built-in `computer_use` toolset also uses MCP
+internally, but owns the connection and presents a smaller Hermes-native tool
+surface. Generate configuration for clients that require direct registration
+with `cua-driver mcp-config --client <client>`.
On Windows and Linux, bare `cua-driver mcp` owns its runtime. On macOS, it
normally proxies to the installed `CuaDriver.app` daemon so Accessibility and
diff --git a/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx b/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
index 0d2d89e1e8..917a8daee1 100644
--- a/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
+++ b/docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
@@ -179,7 +179,6 @@ Restart Cursor and confirm `cua-driver` appears in the MCP server list.
| Antigravity | `cua-driver mcp-config --client antigravity` | Paste into `~/.gemini/config/mcp_config.json`; `--client gemini` is a legacy alias. |
| OpenClaw | `cua-driver mcp-config --client openclaw` | Normal gateway-spawned MCP does not inherit OpenClaw.app's macOS permission grants; embedded hosts should use [Embedding](/reference/cua-driver/embedding). |
| OpenCode | `cua-driver mcp-config --client opencode` | Configure a real MCP server so screenshots are preserved in image blocks. |
-| Hermes | `cua-driver mcp-config --client hermes` | Paste under `mcp_servers` and reload MCP servers in Hermes. |
| Pi | `cua-driver mcp-config --client pi` | Pi does not support MCP natively; use one-shot `cua-driver call …` commands from its shell. |
| Qwen Code | `cua-driver mcp-config --client qwen` | Supports both a CLI add command and `~/.qwen/settings.json`. |
| Factory Droid | `cua-driver mcp-config --client droid` | Supports CLI and JSON config forms. |
diff --git a/docs/content/docs/tutorials/drive-your-first-app.mdx b/docs/content/docs/tutorials/drive-your-first-app.mdx
index 56c6affe5f..b342b444af 100644
--- a/docs/content/docs/tutorials/drive-your-first-app.mdx
+++ b/docs/content/docs/tutorials/drive-your-first-app.mdx
@@ -192,25 +192,19 @@ Register Cua Driver with your agent harness once.
</Callout>
</Tab>
<Tab value="Hermes">
- Print the Hermes snippet:
+ Hermes includes a built-in `computer_use` toolset. Verify it and the
+ available Cua Driver instead of adding a second raw MCP server:
```bash
- cua-driver mcp-config --client hermes
+ hermes computer-use status
+ hermes computer-use doctor
+ hermes tools list
```
- Paste it under mcp_servers in ~/.hermes/config.yaml:
+ If `computer_use` is disabled, enable it for the CLI:
- ```yaml
- mcp_servers:
- cua-driver:
- command: "cua-driver"
- args: ["mcp"]
- ```
-
- Then reload MCP servers inside Hermes:
-
- ```text
- /reload-mcp
+ ```bash
+ hermes tools enable computer_use --platform cli
```
</Tab>
</Tabs>
diff --git a/docs/content/docs/use-cua-with/hermes.mdx b/docs/content/docs/use-cua-with/hermes.mdx
index 14cad54d8d..7c4fd4cfad 100644
--- a/docs/content/docs/use-cua-with/hermes.mdx
+++ b/docs/content/docs/use-cua-with/hermes.mdx
@@ -1,25 +1,50 @@
---
title: Hermes
-description: Connect Nous Research's Hermes Agent to Cua Driver over MCP.
+description: Use Cua Driver through Hermes Agent's built-in Computer Use toolset.
icon: Waypoints
---
-Hermes Agent can launch local MCP servers from `~/.hermes/config.yaml`. Generate the current configuration from Cua Driver:
+Hermes Agent includes a `computer_use` toolset that wraps Cua Driver with
+Hermes-native actions, approvals, image handling, diagnostics, and session
+cleanup. Use this built-in integration instead of adding Cua Driver as a second,
+raw MCP server.
+
+Hermes setup normally attempts to install Cua Driver, but that step is
+best-effort. Install or repair the driver when needed, then verify the complete
+path:
+
+```bash
+hermes computer-use install
+hermes computer-use status
+hermes computer-use doctor
+hermes tools list
+```
+
+If `computer_use` is disabled, enable it for the Hermes CLI:
```bash
-cua-driver mcp-config --client hermes
+hermes tools enable computer_use --platform cli
```
-Paste the generated block under `mcp_servers`, then run `/reload-mcp` inside Hermes. The configuration shape is:
+Start a session with the Computer Use toolset:
-```yaml
-mcp_servers:
- cua-driver:
- command: '/absolute/path/to/cua-driver'
- args: ['mcp']
+```bash
+hermes -t computer_use chat
+```
+
+For deeper platform guidance, install Cua Driver's maintained skill pack. Cua
+Driver links it into the standard Hermes skill directory:
+
+```bash
+cua-driver skills install
+cua-driver skills status
```
-Continue with [Connect your agent to Cua Driver](/how-to-guides/driver/connect-your-agent#other-supported-clients) for runtime and permission guidance.
+Raw `cua-driver mcp` registration remains available for driver development and
+low-level MCP debugging, but it exposes an overlapping interface without
+Hermes's Computer Use wrapper. Do not enable both interfaces by default. The
+[`mcp-config` reference](/reference/cua-driver/cli-reference#cua-driver-mcp-config)
+records that advanced path.
<VideoDemo
src="https://github.com/user-attachments/assets/dcc5a81f-6379-4378-a225-adaf5dfa5dcd"
@@ -30,4 +55,4 @@ Continue with [Connect your agent to Cua Driver](/how-to-guides/driver/connect-y
Independent Hermes agents operate separate apps through the same Cua Driver runtime.
</VideoDemo>
-Upstream: [Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs/).
+Upstream: [Hermes Computer Use documentation](https://hermes-agent.nousresearch.com/docs/user-guide/features/computer-use).