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(cua-driver): document Muse Code setup (#2922)

Francesco Bonacci28fb8086d18a
diff --git a/.github/scripts/tests/test_cua_driver_release_wiring.py b/.github/scripts/tests/test_cua_driver_release_wiring.py
index 16e7df40cf..6a494da93d 100644
--- a/.github/scripts/tests/test_cua_driver_release_wiring.py
+++ b/.github/scripts/tests/test_cua_driver_release_wiring.py
@@ -361,6 +361,17 @@ class TestCuaDriverReleaseWiring(unittest.TestCase):
self.assertIn("launches the installed", shared_hints)
self.assertNotIn("launches CuaDriver", shared_hints)
+ def test_post_install_hints_include_muse_stdio_mcp_config(self) -> None:
+ shared_hints = self.read("libs/cua-driver/scripts/post-install-hints.txt")
+
+ self.assertIn("Muse Code (macOS / Linux", shared_hints)
+ self.assertIn("$XDG_CONFIG_HOME/muse/settings.json", shared_hints)
+ self.assertIn('"mcp_servers": {', shared_hints)
+ self.assertIn('"transport": "stdio"', shared_hints)
+ self.assertIn('"command": "{{BINARY}}"', shared_hints)
+ self.assertIn('"args": ["mcp"]', shared_hints)
+ self.assertIn("MCP servers load at startup", shared_hints)
+
def test_local_macos_signing_uses_an_unambiguous_identity_hash(self) -> None:
signing = self.read("libs/cua-driver/scripts/_local-signing.sh")
diff --git a/libs/cua-driver/README.md b/libs/cua-driver/README.md
index ad30e2e64a..c0d9b8bba2 100644
--- a/libs/cua-driver/README.md
+++ b/libs/cua-driver/README.md
@@ -80,6 +80,31 @@ For direct agent integrations, see the
SDK examples. They connect the agent to `cua-driver mcp` without importing a
generated Cua client.
+## Muse Code
+
+[Muse Code](https://research.meta.ai/blog/introducing-muse-code-and-muse-spark-1-2)
+can use Cua Driver as a local stdio MCP server on macOS and Linux. Merge the
+following entry into `$XDG_CONFIG_HOME/muse/settings.json`, or
+`~/.config/muse/settings.json` when `XDG_CONFIG_HOME` is not set:
+
+```json
+{
+ "mcp_servers": {
+ "cua-driver": {
+ "enabled": true,
+ "transport": "stdio",
+ "command": "/absolute/path/to/cua-driver",
+ "args": ["mcp"]
+ }
+ }
+}
+```
+
+Use the installed binary's absolute path, which `command -v cua-driver` prints.
+Merge the `cua-driver` entry with any existing `mcp_servers` instead of
+replacing the settings file. Start a new Muse session after saving the file;
+Muse loads MCP servers at session startup.
+
Contributor documentation:
- `docs/cursor-themes.md` documents the default semantic cursor and custom
diff --git a/libs/cua-driver/scripts/post-install-hints.txt b/libs/cua-driver/scripts/post-install-hints.txt
index b28f03e656..8b162d1348 100644
--- a/libs/cua-driver/scripts/post-install-hints.txt
+++ b/libs/cua-driver/scripts/post-install-hints.txt
@@ -60,6 +60,20 @@ Next steps:
{{BINARY}} mcp-config --client opencode # JSON for opencode.json
{{BINARY}} mcp-config --client hermes # YAML for ~/.hermes/config.yaml
+ • Muse Code (macOS / Linux — merge into
+ $XDG_CONFIG_HOME/muse/settings.json, or ~/.config/muse/settings.json):
+ {
+ "mcp_servers": {
+ "cua-driver": {
+ "enabled": true,
+ "transport": "stdio",
+ "command": "{{BINARY}}",
+ "args": ["mcp"]
+ }
+ }
+ }
+ Start a new Muse session after saving; MCP servers load at startup.
+
• ZCode (Z.ai — GUI app; paste in Settings → MCP Servers):
{{BINARY}} mcp-config --client zcode