From 5631c69af99cbd6b845b79b8201aa96018a668bd Mon Sep 17 00:00:00 2001
From: Adam <62897873+YeIIcw@users.noreply.github.com>
Date: Wed, 24 Dec 2025 14:19:24 -0500
Subject: [PATCH] Revert "refractor docs into 6 sections"
---
README.md | 22 ++---
.../docs/{agent => agent-sdk}/agent-loops.mdx | 0
.../{agent => agent-sdk}/benchmarks/index.mdx | 0
.../benchmarks/interactive.mdx | 0
.../benchmarks/introduction.mdx | 0
.../{agent => agent-sdk}/benchmarks/meta.json | 0
.../benchmarks/osworld-verified.mdx | 0
.../benchmarks/screenspot-pro.mdx | 0
.../benchmarks/screenspot-v2.mdx | 0
.../callbacks/agent-lifecycle.mdx | 0
.../callbacks/cost-saving.mdx | 0
.../{agent => agent-sdk}/callbacks/index.mdx | 0
.../callbacks/logging.mdx | 0
.../{agent => agent-sdk}/callbacks/meta.json | 0
.../callbacks/pii-anonymization.mdx | 0
.../callbacks/trajectories.mdx | 0
.../{agent => agent-sdk}/chat-history.mdx | 0
.../{agent => agent-sdk}/custom-tools.mdx | 0
.../customizing-computeragent.mdx | 4 +-
.../{agent => agent-sdk}/integrations/hud.mdx | 2 +-
.../integrations/meta.json | 0
.../integrations/observability.mdx | 0
.../mcp-server}/client-integrations.mdx | 2 +-
.../mcp-server}/configuration.mdx | 0
.../{mcp => agent-sdk/mcp-server}/index.mdx | 0
.../mcp-server}/installation.mdx | 0
.../mcp-server}/llm-integrations.mdx | 0
.../{mcp => agent-sdk/mcp-server}/meta.json | 3 -
.../{mcp => agent-sdk/mcp-server}/tools.mdx | 0
.../{mcp => agent-sdk/mcp-server}/usage.mdx | 2 +-
.../{agent => agent-sdk}/message-format.mdx | 0
.../docs/{agent => agent-sdk}/meta.json | 5 +-
.../{agent => agent-sdk}/migration-guide.mdx | 0
.../{agent => agent-sdk}/prompt-caching.mdx | 0
.../supported-agents/composed-agents.mdx | 0
.../supported-agents/computer-use-agents.mdx | 2 +-
.../supported-agents/grounding-models.mdx | 0
.../supported-agents/human-in-the-loop.mdx | 0
.../supported-agents/meta.json | 0
.../cua-vlm-router.mdx | 8 +-
.../supported-model-providers/index.mdx | 2 +-
.../local-models.mdx | 0
.../docs/{agent => agent-sdk}/telemetry.mdx | 0
.../{agent => agent-sdk}/usage-tracking.mdx | 0
docs/content/docs/cli-playbook/commands.mdx | 4 +-
.../cloud-vm-management.mdx | 0
.../{computer => computer-sdk}/commands.mdx | 2 +-
.../computer-server/Commands.mdx | 0
.../computer-server/REST-API.mdx | 0
.../computer-server/WebSocket-API.mdx | 0
.../computer-server/index.mdx | 0
.../computer-server/meta.json | 0
.../computer-ui.mdx | 0
.../{computer => computer-sdk}/computers.mdx | 0
.../custom-computer-handlers.mdx | 0
.../docs/{computer => computer-sdk}/meta.json | 2 +-
.../sandboxed-python.mdx | 0
.../tracing-api.mdx | 0
.../docs/example-usecases/form-filling.mdx | 8 +-
.../gemini-complex-ui-navigation.mdx | 2 +-
.../post-event-contact-export.mdx | 8 +-
.../windows-app-behind-vpn.mdx | 6 +-
docs/content/docs/get-started/quickstart.mdx | 16 ++--
docs/content/docs/index.mdx | 4 +-
docs/content/docs/lume/meta.json | 5 --
docs/content/docs/lumier/meta.json | 5 --
.../lume/cli-reference.mdx | 0
.../{ => macos-vm-cli-playbook}/lume/faq.md | 0
.../lume/http-api.mdx | 0
.../lume/index.mdx | 0
.../lume/installation.mdx | 0
.../docs/macos-vm-cli-playbook/lume/meta.json | 3 +
.../lume/prebuilt-images.mdx | 0
.../lumier/building-lumier.mdx | 0
.../lumier/docker-compose.mdx | 0
.../lumier/docker.mdx | 0
.../lumier/index.mdx | 0
.../lumier/installation.mdx | 0
.../macos-vm-cli-playbook/lumier/meta.json | 3 +
.../docs/macos-vm-cli-playbook/meta.json | 5 ++
docs/content/docs/meta.json | 20 ++---
docs/content/docs/som/index.mdx | 82 -------------------
docs/content/docs/som/meta.json | 5 --
docs/next.config.mjs | 35 +-------
docs/src/components/footer.tsx | 2 +-
libs/lume/README.md | 10 +--
libs/lumier/README.md | 10 +--
libs/python/agent/README.md | 20 ++---
libs/python/computer-server/README.md | 8 +-
libs/python/computer/README.md | 8 +-
libs/python/mcp-server/README.md | 12 +--
libs/typescript/computer/README.md | 6 +-
92 files changed, 109 insertions(+), 234 deletions(-)
rename docs/content/docs/{agent => agent-sdk}/agent-loops.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/index.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/interactive.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/introduction.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/meta.json (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/osworld-verified.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/screenspot-pro.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/benchmarks/screenspot-v2.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/agent-lifecycle.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/cost-saving.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/index.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/logging.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/meta.json (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/pii-anonymization.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/callbacks/trajectories.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/chat-history.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/custom-tools.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/customizing-computeragent.mdx (96%)
rename docs/content/docs/{agent => agent-sdk}/integrations/hud.mdx (97%)
rename docs/content/docs/{agent => agent-sdk}/integrations/meta.json (100%)
rename docs/content/docs/{agent => agent-sdk}/integrations/observability.mdx (100%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/client-integrations.mdx (97%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/configuration.mdx (100%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/index.mdx (100%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/installation.mdx (100%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/llm-integrations.mdx (100%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/meta.json (58%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/tools.mdx (100%)
rename docs/content/docs/{mcp => agent-sdk/mcp-server}/usage.mdx (97%)
rename docs/content/docs/{agent => agent-sdk}/message-format.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/meta.json (85%)
rename docs/content/docs/{agent => agent-sdk}/migration-guide.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/prompt-caching.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/supported-agents/composed-agents.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/supported-agents/computer-use-agents.mdx (95%)
rename docs/content/docs/{agent => agent-sdk}/supported-agents/grounding-models.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/supported-agents/human-in-the-loop.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/supported-agents/meta.json (100%)
rename docs/content/docs/{agent => agent-sdk}/supported-model-providers/cua-vlm-router.mdx (96%)
rename docs/content/docs/{agent => agent-sdk}/supported-model-providers/index.mdx (97%)
rename docs/content/docs/{agent => agent-sdk}/supported-model-providers/local-models.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/telemetry.mdx (100%)
rename docs/content/docs/{agent => agent-sdk}/usage-tracking.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/cloud-vm-management.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/commands.mdx (98%)
rename docs/content/docs/{computer => computer-sdk}/computer-server/Commands.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/computer-server/REST-API.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/computer-server/WebSocket-API.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/computer-server/index.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/computer-server/meta.json (100%)
rename docs/content/docs/{computer => computer-sdk}/computer-ui.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/computers.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/custom-computer-handlers.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/meta.json (89%)
rename docs/content/docs/{computer => computer-sdk}/sandboxed-python.mdx (100%)
rename docs/content/docs/{computer => computer-sdk}/tracing-api.mdx (100%)
delete mode 100644 docs/content/docs/lume/meta.json
delete mode 100644 docs/content/docs/lumier/meta.json
rename docs/content/docs/{ => macos-vm-cli-playbook}/lume/cli-reference.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lume/faq.md (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lume/http-api.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lume/index.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lume/installation.mdx (100%)
create mode 100644 docs/content/docs/macos-vm-cli-playbook/lume/meta.json
rename docs/content/docs/{ => macos-vm-cli-playbook}/lume/prebuilt-images.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lumier/building-lumier.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lumier/docker-compose.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lumier/docker.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lumier/index.mdx (100%)
rename docs/content/docs/{ => macos-vm-cli-playbook}/lumier/installation.mdx (100%)
create mode 100644 docs/content/docs/macos-vm-cli-playbook/lumier/meta.json
create mode 100644 docs/content/docs/macos-vm-cli-playbook/meta.json
delete mode 100644 docs/content/docs/som/index.mdx
delete mode 100644 docs/content/docs/som/meta.json
diff --git a/README.md b/README.md
index 93412ad9..56c2558e 100644
--- a/README.md
+++ b/README.md
@@ -32,14 +32,14 @@ Computer-Use Agents (CUAs) are AI systems that can autonomously interact with co
With the [Computer SDK](#computer-sdk), you can:
-- automate Windows, Linux, and macOS VMs with a consistent, [pyautogui-like API](https://cua.ai/docs/computer/commands)
+- automate Windows, Linux, and macOS VMs with a consistent, [pyautogui-like API](https://cua.ai/docs/computer-sdk/commands)
- create & manage VMs [locally](https://cua.ai/docs/quickstart-devs#using-computer) or using [Cua cloud](https://www.cua.ai/)
With the [Agent SDK](#agent-sdk), you can:
-- run computer-use models with a [consistent schema](https://cua.ai/docs/agent/message-format)
-- benchmark on OSWorld-Verified (369 tasks), SheetBench-V2, and ScreenSpot [with a single line of code using HUD](https://cua.ai/docs/agent/integrations/hud) - see [benchmark results](#research--benchmarks) ([Notebook](https://github.com/trycua/cua/blob/main/notebooks/eval_osworld.ipynb))
-- combine UI grounding models with any LLM using [composed agents](https://cua.ai/docs/agent/supported-agents/composed-agents)
+- run computer-use models with a [consistent schema](https://cua.ai/docs/agent-sdk/message-format)
+- benchmark on OSWorld-Verified (369 tasks), SheetBench-V2, and ScreenSpot [with a single line of code using HUD](https://cua.ai/docs/agent-sdk/integrations/hud) - see [benchmark results](#research--benchmarks) ([Notebook](https://github.com/trycua/cua/blob/main/notebooks/eval_osworld.ipynb))
+- combine UI grounding models with any LLM using [composed agents](https://cua.ai/docs/agent-sdk/supported-agents/composed-agents)
- use new UI agent models and UI grounding models from the Model Zoo below with just a model string (e.g., `ComputerAgent(model="openai/computer-use-preview")`)
- use API or local inference by changing a prefix (e.g., `openai/`, `openrouter/`, `ollama/`, `huggingface-local/`, `mlx/`, [etc.](https://docs.litellm.ai/docs/providers))
@@ -208,12 +208,12 @@ Cua uses the OpenAI Agent response format.
These are the valid model configurations for `ComputerAgent(model="...")`:
-| Configuration | Description |
-| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `{computer-use-model}` | A single model to perform all computer-use tasks |
-| `{grounding-model}+{any-vlm-with-tools}` | [Composed](https://cua.ai/docs/agent/supported-agents/composed-agents) with VLM for captioning and grounding LLM for element detection |
-| `moondream3+{any-llm-with-tools}` | [Composed](https://cua.ai/docs/agent/supported-agents/composed-agents) with Moondream3 for captioning and UI element detection |
-| `human/human` | A [human-in-the-loop](https://cua.ai/docs/agent/supported-agents/human-in-the-loop) in place of a model |
+| Configuration | Description |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `{computer-use-model}` | A single model to perform all computer-use tasks |
+| `{grounding-model}+{any-vlm-with-tools}` | [Composed](https://cua.ai/docs/agent-sdk/supported-agents/composed-agents) with VLM for captioning and grounding LLM for element detection |
+| `moondream3+{any-llm-with-tools}` | [Composed](https://cua.ai/docs/agent-sdk/supported-agents/composed-agents) with Moondream3 for captioning and UI element detection |
+| `human/human` | A [human-in-the-loop](https://cua.ai/docs/agent-sdk/supported-agents/human-in-the-loop) in place of a model |
### Model Capabilities
@@ -246,7 +246,7 @@ The following table shows which capabilities are supported by each model:
**Composition Examples:**
-See more examples on our [composition docs](https://cua.ai/docs/agent/supported-agents/composed-agents).
+See more examples on our [composition docs](https://cua.ai/docs/agent-sdk/supported-agents/composed-agents).
```python
# Use OpenAI's GPT-5 for planning with specialized grounding
diff --git a/docs/content/docs/agent/agent-loops.mdx b/docs/content/docs/agent-sdk/agent-loops.mdx
similarity index 100%
rename from docs/content/docs/agent/agent-loops.mdx
rename to docs/content/docs/agent-sdk/agent-loops.mdx
diff --git a/docs/content/docs/agent/benchmarks/index.mdx b/docs/content/docs/agent-sdk/benchmarks/index.mdx
similarity index 100%
rename from docs/content/docs/agent/benchmarks/index.mdx
rename to docs/content/docs/agent-sdk/benchmarks/index.mdx
diff --git a/docs/content/docs/agent/benchmarks/interactive.mdx b/docs/content/docs/agent-sdk/benchmarks/interactive.mdx
similarity index 100%
rename from docs/content/docs/agent/benchmarks/interactive.mdx
rename to docs/content/docs/agent-sdk/benchmarks/interactive.mdx
diff --git a/docs/content/docs/agent/benchmarks/introduction.mdx b/docs/content/docs/agent-sdk/benchmarks/introduction.mdx
similarity index 100%
rename from docs/content/docs/agent/benchmarks/introduction.mdx
rename to docs/content/docs/agent-sdk/benchmarks/introduction.mdx
diff --git a/docs/content/docs/agent/benchmarks/meta.json b/docs/content/docs/agent-sdk/benchmarks/meta.json
similarity index 100%
rename from docs/content/docs/agent/benchmarks/meta.json
rename to docs/content/docs/agent-sdk/benchmarks/meta.json
diff --git a/docs/content/docs/agent/benchmarks/osworld-verified.mdx b/docs/content/docs/agent-sdk/benchmarks/osworld-verified.mdx
similarity index 100%
rename from docs/content/docs/agent/benchmarks/osworld-verified.mdx
rename to docs/content/docs/agent-sdk/benchmarks/osworld-verified.mdx
diff --git a/docs/content/docs/agent/benchmarks/screenspot-pro.mdx b/docs/content/docs/agent-sdk/benchmarks/screenspot-pro.mdx
similarity index 100%
rename from docs/content/docs/agent/benchmarks/screenspot-pro.mdx
rename to docs/content/docs/agent-sdk/benchmarks/screenspot-pro.mdx
diff --git a/docs/content/docs/agent/benchmarks/screenspot-v2.mdx b/docs/content/docs/agent-sdk/benchmarks/screenspot-v2.mdx
similarity index 100%
rename from docs/content/docs/agent/benchmarks/screenspot-v2.mdx
rename to docs/content/docs/agent-sdk/benchmarks/screenspot-v2.mdx
diff --git a/docs/content/docs/agent/callbacks/agent-lifecycle.mdx b/docs/content/docs/agent-sdk/callbacks/agent-lifecycle.mdx
similarity index 100%
rename from docs/content/docs/agent/callbacks/agent-lifecycle.mdx
rename to docs/content/docs/agent-sdk/callbacks/agent-lifecycle.mdx
diff --git a/docs/content/docs/agent/callbacks/cost-saving.mdx b/docs/content/docs/agent-sdk/callbacks/cost-saving.mdx
similarity index 100%
rename from docs/content/docs/agent/callbacks/cost-saving.mdx
rename to docs/content/docs/agent-sdk/callbacks/cost-saving.mdx
diff --git a/docs/content/docs/agent/callbacks/index.mdx b/docs/content/docs/agent-sdk/callbacks/index.mdx
similarity index 100%
rename from docs/content/docs/agent/callbacks/index.mdx
rename to docs/content/docs/agent-sdk/callbacks/index.mdx
diff --git a/docs/content/docs/agent/callbacks/logging.mdx b/docs/content/docs/agent-sdk/callbacks/logging.mdx
similarity index 100%
rename from docs/content/docs/agent/callbacks/logging.mdx
rename to docs/content/docs/agent-sdk/callbacks/logging.mdx
diff --git a/docs/content/docs/agent/callbacks/meta.json b/docs/content/docs/agent-sdk/callbacks/meta.json
similarity index 100%
rename from docs/content/docs/agent/callbacks/meta.json
rename to docs/content/docs/agent-sdk/callbacks/meta.json
diff --git a/docs/content/docs/agent/callbacks/pii-anonymization.mdx b/docs/content/docs/agent-sdk/callbacks/pii-anonymization.mdx
similarity index 100%
rename from docs/content/docs/agent/callbacks/pii-anonymization.mdx
rename to docs/content/docs/agent-sdk/callbacks/pii-anonymization.mdx
diff --git a/docs/content/docs/agent/callbacks/trajectories.mdx b/docs/content/docs/agent-sdk/callbacks/trajectories.mdx
similarity index 100%
rename from docs/content/docs/agent/callbacks/trajectories.mdx
rename to docs/content/docs/agent-sdk/callbacks/trajectories.mdx
diff --git a/docs/content/docs/agent/chat-history.mdx b/docs/content/docs/agent-sdk/chat-history.mdx
similarity index 100%
rename from docs/content/docs/agent/chat-history.mdx
rename to docs/content/docs/agent-sdk/chat-history.mdx
diff --git a/docs/content/docs/agent/custom-tools.mdx b/docs/content/docs/agent-sdk/custom-tools.mdx
similarity index 100%
rename from docs/content/docs/agent/custom-tools.mdx
rename to docs/content/docs/agent-sdk/custom-tools.mdx
diff --git a/docs/content/docs/agent/customizing-computeragent.mdx b/docs/content/docs/agent-sdk/customizing-computeragent.mdx
similarity index 96%
rename from docs/content/docs/agent/customizing-computeragent.mdx
rename to docs/content/docs/agent-sdk/customizing-computeragent.mdx
index 3999bc67..158495e0 100644
--- a/docs/content/docs/agent/customizing-computeragent.mdx
+++ b/docs/content/docs/agent-sdk/customizing-computeragent.mdx
@@ -63,8 +63,8 @@ agent = ComputerAgent(
)
```
-- See `docs/agent/custom-tools` for authoring function tools.
-- See `docs/computer/custom-computer-handlers` for building full computer interfaces.
+- See `docs/agent-sdk/custom-tools` for authoring function tools.
+- See `docs/agent-sdk/custom-computer-handlers` for building full computer interfaces.
## 3) Intermediate: Callbacks
diff --git a/docs/content/docs/agent/integrations/hud.mdx b/docs/content/docs/agent-sdk/integrations/hud.mdx
similarity index 97%
rename from docs/content/docs/agent/integrations/hud.mdx
rename to docs/content/docs/agent-sdk/integrations/hud.mdx
index 6d1a923d..7bfcbdea 100644
--- a/docs/content/docs/agent/integrations/hud.mdx
+++ b/docs/content/docs/agent-sdk/integrations/hud.mdx
@@ -125,7 +125,7 @@ Both single-task and full-dataset runs share a common set of configuration optio
HUD provides multiple benchmark datasets for realistic evaluation.
-1. **[OSWorld-Verified](/agent/benchmarks/osworld-verified)** – Benchmark on 369+ real-world desktop tasks across Chrome, LibreOffice, GIMP, VS Code, etc.
+1. **[OSWorld-Verified](/agent-sdk/benchmarks/osworld-verified)** – Benchmark on 369+ real-world desktop tasks across Chrome, LibreOffice, GIMP, VS Code, etc.
_Best for_: evaluating full computer-use agents in realistic environments.
_Verified variant_: fixes 300+ issues from earlier versions for reliability.
diff --git a/docs/content/docs/agent/integrations/meta.json b/docs/content/docs/agent-sdk/integrations/meta.json
similarity index 100%
rename from docs/content/docs/agent/integrations/meta.json
rename to docs/content/docs/agent-sdk/integrations/meta.json
diff --git a/docs/content/docs/agent/integrations/observability.mdx b/docs/content/docs/agent-sdk/integrations/observability.mdx
similarity index 100%
rename from docs/content/docs/agent/integrations/observability.mdx
rename to docs/content/docs/agent-sdk/integrations/observability.mdx
diff --git a/docs/content/docs/mcp/client-integrations.mdx b/docs/content/docs/agent-sdk/mcp-server/client-integrations.mdx
similarity index 97%
rename from docs/content/docs/mcp/client-integrations.mdx
rename to docs/content/docs/agent-sdk/mcp-server/client-integrations.mdx
index fe1f836e..43d76ab5 100644
--- a/docs/content/docs/mcp/client-integrations.mdx
+++ b/docs/content/docs/agent-sdk/mcp-server/client-integrations.mdx
@@ -120,4 +120,4 @@ All MCP clients can configure the server using environment variables:
- `CUA_MAX_IMAGES` - Maximum images to keep in context
- `CUA_USE_HOST_COMPUTER_SERVER` - Use host system instead of VM
-See the [Configuration](/mcp/configuration) page for detailed configuration options.
+See the [Configuration](/docs/libraries/mcp-server/configuration) page for detailed configuration options.
diff --git a/docs/content/docs/mcp/configuration.mdx b/docs/content/docs/agent-sdk/mcp-server/configuration.mdx
similarity index 100%
rename from docs/content/docs/mcp/configuration.mdx
rename to docs/content/docs/agent-sdk/mcp-server/configuration.mdx
diff --git a/docs/content/docs/mcp/index.mdx b/docs/content/docs/agent-sdk/mcp-server/index.mdx
similarity index 100%
rename from docs/content/docs/mcp/index.mdx
rename to docs/content/docs/agent-sdk/mcp-server/index.mdx
diff --git a/docs/content/docs/mcp/installation.mdx b/docs/content/docs/agent-sdk/mcp-server/installation.mdx
similarity index 100%
rename from docs/content/docs/mcp/installation.mdx
rename to docs/content/docs/agent-sdk/mcp-server/installation.mdx
diff --git a/docs/content/docs/mcp/llm-integrations.mdx b/docs/content/docs/agent-sdk/mcp-server/llm-integrations.mdx
similarity index 100%
rename from docs/content/docs/mcp/llm-integrations.mdx
rename to docs/content/docs/agent-sdk/mcp-server/llm-integrations.mdx
diff --git a/docs/content/docs/mcp/meta.json b/docs/content/docs/agent-sdk/mcp-server/meta.json
similarity index 58%
rename from docs/content/docs/mcp/meta.json
rename to docs/content/docs/agent-sdk/mcp-server/meta.json
index 62ca56ff..f5ccb9ba 100644
--- a/docs/content/docs/mcp/meta.json
+++ b/docs/content/docs/agent-sdk/mcp-server/meta.json
@@ -1,8 +1,5 @@
{
- "title": "MCP",
- "description": "MCP server for using Cua agents and computers",
"pages": [
- "index",
"installation",
"configuration",
"usage",
diff --git a/docs/content/docs/mcp/tools.mdx b/docs/content/docs/agent-sdk/mcp-server/tools.mdx
similarity index 100%
rename from docs/content/docs/mcp/tools.mdx
rename to docs/content/docs/agent-sdk/mcp-server/tools.mdx
diff --git a/docs/content/docs/mcp/usage.mdx b/docs/content/docs/agent-sdk/mcp-server/usage.mdx
similarity index 97%
rename from docs/content/docs/mcp/usage.mdx
rename to docs/content/docs/agent-sdk/mcp-server/usage.mdx
index 5048a19f..d65fc644 100644
--- a/docs/content/docs/mcp/usage.mdx
+++ b/docs/content/docs/agent-sdk/mcp-server/usage.mdx
@@ -82,7 +82,7 @@ Add the `CUA_USE_HOST_COMPUTER_SERVER` environment variable to your MCP client c
- Update your Claude Desktop config (see [Installation](/mcp/installation)) to include the environment variable:
+ Update your Claude Desktop config (see [Installation](/docs/libraries/mcp-server/installation)) to include the environment variable:
```json
{
diff --git a/docs/content/docs/agent/message-format.mdx b/docs/content/docs/agent-sdk/message-format.mdx
similarity index 100%
rename from docs/content/docs/agent/message-format.mdx
rename to docs/content/docs/agent-sdk/message-format.mdx
diff --git a/docs/content/docs/agent/meta.json b/docs/content/docs/agent-sdk/meta.json
similarity index 85%
rename from docs/content/docs/agent/meta.json
rename to docs/content/docs/agent-sdk/meta.json
index ce3f6421..6bb01b62 100644
--- a/docs/content/docs/agent/meta.json
+++ b/docs/content/docs/agent-sdk/meta.json
@@ -1,5 +1,5 @@
{
- "title": "Agent",
+ "title": "Agent SDK",
"description": "Build computer-using agents with the Agent SDK",
"pages": [
"agent-loops",
@@ -14,6 +14,7 @@
"usage-tracking",
"telemetry",
"benchmarks",
- "integrations"
+ "integrations",
+ "mcp-server"
]
}
diff --git a/docs/content/docs/agent/migration-guide.mdx b/docs/content/docs/agent-sdk/migration-guide.mdx
similarity index 100%
rename from docs/content/docs/agent/migration-guide.mdx
rename to docs/content/docs/agent-sdk/migration-guide.mdx
diff --git a/docs/content/docs/agent/prompt-caching.mdx b/docs/content/docs/agent-sdk/prompt-caching.mdx
similarity index 100%
rename from docs/content/docs/agent/prompt-caching.mdx
rename to docs/content/docs/agent-sdk/prompt-caching.mdx
diff --git a/docs/content/docs/agent/supported-agents/composed-agents.mdx b/docs/content/docs/agent-sdk/supported-agents/composed-agents.mdx
similarity index 100%
rename from docs/content/docs/agent/supported-agents/composed-agents.mdx
rename to docs/content/docs/agent-sdk/supported-agents/composed-agents.mdx
diff --git a/docs/content/docs/agent/supported-agents/computer-use-agents.mdx b/docs/content/docs/agent-sdk/supported-agents/computer-use-agents.mdx
similarity index 95%
rename from docs/content/docs/agent/supported-agents/computer-use-agents.mdx
rename to docs/content/docs/agent-sdk/supported-agents/computer-use-agents.mdx
index 7b3d5faf..74371087 100644
--- a/docs/content/docs/agent/supported-agents/computer-use-agents.mdx
+++ b/docs/content/docs/agent-sdk/supported-agents/computer-use-agents.mdx
@@ -7,7 +7,7 @@ These models support complete computer-use agent functionality through `Computer
All agent loops are compatible with any LLM provider supported by LiteLLM.
-See [Running Models Locally](/agent/supported-model-providers/local-models) for how to use Hugging Face and MLX models on your own machine.
+See [Running Models Locally](/agent-sdk/supported-model-providers/local-models) for how to use Hugging Face and MLX models on your own machine.
## Gemini CUA
diff --git a/docs/content/docs/agent/supported-agents/grounding-models.mdx b/docs/content/docs/agent-sdk/supported-agents/grounding-models.mdx
similarity index 100%
rename from docs/content/docs/agent/supported-agents/grounding-models.mdx
rename to docs/content/docs/agent-sdk/supported-agents/grounding-models.mdx
diff --git a/docs/content/docs/agent/supported-agents/human-in-the-loop.mdx b/docs/content/docs/agent-sdk/supported-agents/human-in-the-loop.mdx
similarity index 100%
rename from docs/content/docs/agent/supported-agents/human-in-the-loop.mdx
rename to docs/content/docs/agent-sdk/supported-agents/human-in-the-loop.mdx
diff --git a/docs/content/docs/agent/supported-agents/meta.json b/docs/content/docs/agent-sdk/supported-agents/meta.json
similarity index 100%
rename from docs/content/docs/agent/supported-agents/meta.json
rename to docs/content/docs/agent-sdk/supported-agents/meta.json
diff --git a/docs/content/docs/agent/supported-model-providers/cua-vlm-router.mdx b/docs/content/docs/agent-sdk/supported-model-providers/cua-vlm-router.mdx
similarity index 96%
rename from docs/content/docs/agent/supported-model-providers/cua-vlm-router.mdx
rename to docs/content/docs/agent-sdk/supported-model-providers/cua-vlm-router.mdx
index 19dd93fd..d09cfe9f 100644
--- a/docs/content/docs/agent/supported-model-providers/cua-vlm-router.mdx
+++ b/docs/content/docs/agent-sdk/supported-model-providers/cua-vlm-router.mdx
@@ -224,7 +224,7 @@ Requests are billed in **credits**:
}
```
-**Note:** Cua VLM Router is a fully managed cloud service. If you want to use your own provider API keys directly (BYOK), see the [Supported Model Providers](/agent/supported-model-providers/) page for direct provider access via the agent SDK.
+**Note:** Cua VLM Router is a fully managed cloud service. If you want to use your own provider API keys directly (BYOK), see the [Supported Model Providers](/agent-sdk/supported-model-providers/) page for direct provider access via the agent SDK.
## Response Metadata
@@ -435,7 +435,7 @@ That's it! Same code structure, just different model format. Cua manages all pro
## Next Steps
-- Explore [Agent Loops](/agent/agent-loops) to customize agent behavior
-- Learn about [Cost Saving Callbacks](/agent/callbacks/cost-saving)
+- Explore [Agent Loops](/agent-sdk/agent-loops) to customize agent behavior
+- Learn about [Cost Saving Callbacks](/agent-sdk/callbacks/cost-saving)
- Try [Example Use Cases](/example-usecases/form-filling)
-- Review [Supported Model Providers](/agent/supported-model-providers/) for all options
+- Review [Supported Model Providers](/agent-sdk/supported-model-providers/) for all options
diff --git a/docs/content/docs/agent/supported-model-providers/index.mdx b/docs/content/docs/agent-sdk/supported-model-providers/index.mdx
similarity index 97%
rename from docs/content/docs/agent/supported-model-providers/index.mdx
rename to docs/content/docs/agent-sdk/supported-model-providers/index.mdx
index 90abee44..d27aab31 100644
--- a/docs/content/docs/agent/supported-model-providers/index.mdx
+++ b/docs/content/docs/agent-sdk/supported-model-providers/index.mdx
@@ -24,7 +24,7 @@ model="cua/google/gemini-3-flash-preview" # Gemini 3 Flash Preview (fastest and
- Cost tracking and optimization
- Fully managed infrastructure (no provider keys to manage)
-[Learn more about Cua VLM Router →](/agent/supported-model-providers/cua-vlm-router)
+[Learn more about Cua VLM Router →](/agent-sdk/supported-model-providers/cua-vlm-router)
---
diff --git a/docs/content/docs/agent/supported-model-providers/local-models.mdx b/docs/content/docs/agent-sdk/supported-model-providers/local-models.mdx
similarity index 100%
rename from docs/content/docs/agent/supported-model-providers/local-models.mdx
rename to docs/content/docs/agent-sdk/supported-model-providers/local-models.mdx
diff --git a/docs/content/docs/agent/telemetry.mdx b/docs/content/docs/agent-sdk/telemetry.mdx
similarity index 100%
rename from docs/content/docs/agent/telemetry.mdx
rename to docs/content/docs/agent-sdk/telemetry.mdx
diff --git a/docs/content/docs/agent/usage-tracking.mdx b/docs/content/docs/agent-sdk/usage-tracking.mdx
similarity index 100%
rename from docs/content/docs/agent/usage-tracking.mdx
rename to docs/content/docs/agent-sdk/usage-tracking.mdx
diff --git a/docs/content/docs/cli-playbook/commands.mdx b/docs/content/docs/cli-playbook/commands.mdx
index 089f0980..d123221c 100644
--- a/docs/content/docs/cli-playbook/commands.mdx
+++ b/docs/content/docs/cli-playbook/commands.mdx
@@ -429,5 +429,5 @@ watch -n 5 cua list
## Next Steps
- [Get started with the quickstart guide](/get-started/quickstart#cli-quickstart)
-- [Learn about CUA computers](/computer/computers)
-- [Explore agent automation](/agent/agent-loops)
+- [Learn about CUA computers](/computer-sdk/computers)
+- [Explore agent automation](/agent-sdk/agent-loops)
diff --git a/docs/content/docs/computer/cloud-vm-management.mdx b/docs/content/docs/computer-sdk/cloud-vm-management.mdx
similarity index 100%
rename from docs/content/docs/computer/cloud-vm-management.mdx
rename to docs/content/docs/computer-sdk/cloud-vm-management.mdx
diff --git a/docs/content/docs/computer/commands.mdx b/docs/content/docs/computer-sdk/commands.mdx
similarity index 98%
rename from docs/content/docs/computer/commands.mdx
rename to docs/content/docs/computer-sdk/commands.mdx
index 5c2e5e45..4fc7b0ff 100644
--- a/docs/content/docs/computer/commands.mdx
+++ b/docs/content/docs/computer-sdk/commands.mdx
@@ -5,7 +5,7 @@ description: Computer commands and interface methods
This page describes the set of supported **commands** you can use to control a Cua Computer Framework directly via the Python SDK.
-These commands map to the same actions available in the [Computer Server API Commands Reference](/computer/computer-server/Commands), and provide low-level, async access to system operations from your agent or automation code.
+These commands map to the same actions available in the [Computer Server API Commands Reference](/computer-sdk/computer-server/Commands), and provide low-level, async access to system operations from your agent or automation code.
## Shell Actions
diff --git a/docs/content/docs/computer/computer-server/Commands.mdx b/docs/content/docs/computer-sdk/computer-server/Commands.mdx
similarity index 100%
rename from docs/content/docs/computer/computer-server/Commands.mdx
rename to docs/content/docs/computer-sdk/computer-server/Commands.mdx
diff --git a/docs/content/docs/computer/computer-server/REST-API.mdx b/docs/content/docs/computer-sdk/computer-server/REST-API.mdx
similarity index 100%
rename from docs/content/docs/computer/computer-server/REST-API.mdx
rename to docs/content/docs/computer-sdk/computer-server/REST-API.mdx
diff --git a/docs/content/docs/computer/computer-server/WebSocket-API.mdx b/docs/content/docs/computer-sdk/computer-server/WebSocket-API.mdx
similarity index 100%
rename from docs/content/docs/computer/computer-server/WebSocket-API.mdx
rename to docs/content/docs/computer-sdk/computer-server/WebSocket-API.mdx
diff --git a/docs/content/docs/computer/computer-server/index.mdx b/docs/content/docs/computer-sdk/computer-server/index.mdx
similarity index 100%
rename from docs/content/docs/computer/computer-server/index.mdx
rename to docs/content/docs/computer-sdk/computer-server/index.mdx
diff --git a/docs/content/docs/computer/computer-server/meta.json b/docs/content/docs/computer-sdk/computer-server/meta.json
similarity index 100%
rename from docs/content/docs/computer/computer-server/meta.json
rename to docs/content/docs/computer-sdk/computer-server/meta.json
diff --git a/docs/content/docs/computer/computer-ui.mdx b/docs/content/docs/computer-sdk/computer-ui.mdx
similarity index 100%
rename from docs/content/docs/computer/computer-ui.mdx
rename to docs/content/docs/computer-sdk/computer-ui.mdx
diff --git a/docs/content/docs/computer/computers.mdx b/docs/content/docs/computer-sdk/computers.mdx
similarity index 100%
rename from docs/content/docs/computer/computers.mdx
rename to docs/content/docs/computer-sdk/computers.mdx
diff --git a/docs/content/docs/computer/custom-computer-handlers.mdx b/docs/content/docs/computer-sdk/custom-computer-handlers.mdx
similarity index 100%
rename from docs/content/docs/computer/custom-computer-handlers.mdx
rename to docs/content/docs/computer-sdk/custom-computer-handlers.mdx
diff --git a/docs/content/docs/computer/meta.json b/docs/content/docs/computer-sdk/meta.json
similarity index 89%
rename from docs/content/docs/computer/meta.json
rename to docs/content/docs/computer-sdk/meta.json
index 5788a269..83d06b59 100644
--- a/docs/content/docs/computer/meta.json
+++ b/docs/content/docs/computer-sdk/meta.json
@@ -1,5 +1,5 @@
{
- "title": "Computer",
+ "title": "Computer SDK",
"description": "Build computer-using agents with the Computer SDK",
"pages": [
"computers",
diff --git a/docs/content/docs/computer/sandboxed-python.mdx b/docs/content/docs/computer-sdk/sandboxed-python.mdx
similarity index 100%
rename from docs/content/docs/computer/sandboxed-python.mdx
rename to docs/content/docs/computer-sdk/sandboxed-python.mdx
diff --git a/docs/content/docs/computer/tracing-api.mdx b/docs/content/docs/computer-sdk/tracing-api.mdx
similarity index 100%
rename from docs/content/docs/computer/tracing-api.mdx
rename to docs/content/docs/computer-sdk/tracing-api.mdx
diff --git a/docs/content/docs/example-usecases/form-filling.mdx b/docs/content/docs/example-usecases/form-filling.mdx
index 42092cef..d133aa02 100644
--- a/docs/content/docs/example-usecases/form-filling.mdx
+++ b/docs/content/docs/example-usecases/form-filling.mdx
@@ -10,7 +10,7 @@ import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
Cua can be used to automate interactions between form filling and local file systems over any operating system. Cua let's you interact with all the elements of a web page and local file systems to integrate between the two.
-This preset usecase uses [Cua Computer Framework](/computer/computers) to interact with a web page and local file systems along with [Agent Loops](/agent/agent-loops) to run the agent in a loop with message history.
+This preset usecase uses [Cua Computer Framework](/computer-sdk/computers) to interact with a web page and local file systems along with [Agent Loops](/agent-sdk/agent-loops) to run the agent in a loop with message history.
---
@@ -494,7 +494,7 @@ Monitor the output to see the agent's progress through each task.
## Next Steps
-- Learn more about [Cua Computer Framework](/computer/computers) and [Computer Commands](/computer/commands)
-- Read about [Agent Loops](/agent/agent-loops), [Tools](/agent/custom-tools), and [Supported Model Providers](/agent/supported-model-providers/)
-- Experiment with different [Models and Providers](/agent/supported-model-providers/)
+- Learn more about [Cua Computer Framework](/computer-sdk/computers) and [Computer Commands](/computer-sdk/commands)
+- Read about [Agent Loops](/agent-sdk/agent-loops), [Tools](/agent-sdk/custom-tools), and [Supported Model Providers](/agent-sdk/supported-model-providers/)
+- Experiment with different [Models and Providers](/agent-sdk/supported-model-providers/)
- Join our [Discord community](https://discord.com/invite/mVnXXpdE85) for help
diff --git a/docs/content/docs/example-usecases/gemini-complex-ui-navigation.mdx b/docs/content/docs/example-usecases/gemini-complex-ui-navigation.mdx
index a0297e97..4a3d1d0f 100644
--- a/docs/content/docs/example-usecases/gemini-complex-ui-navigation.mdx
+++ b/docs/content/docs/example-usecases/gemini-complex-ui-navigation.mdx
@@ -633,7 +633,7 @@ Ensure billing is enabled for your Google Cloud project. Visit the [Billing sect
## Next Steps
-- Learn more about [OmniParser agent loops](/agent/agent-loops)
+- Learn more about [OmniParser agent loops](/agent-sdk/agent-loops)
- Explore [Vertex AI pricing](https://cloud.google.com/vertex-ai/pricing)
- Read about [ScreenSpot-Pro benchmark](https://github.com/likaixin2000/ScreenSpot-Pro-GUI-Grounding)
- Check out [Google's Gemini 3 announcement](https://blog.google/products/gemini/gemini-3/)
diff --git a/docs/content/docs/example-usecases/post-event-contact-export.mdx b/docs/content/docs/example-usecases/post-event-contact-export.mdx
index e16df032..7eaef596 100644
--- a/docs/content/docs/example-usecases/post-event-contact-export.mdx
+++ b/docs/content/docs/example-usecases/post-event-contact-export.mdx
@@ -12,7 +12,7 @@ After networking events, you need to export new connections from LinkedIn, X, or
**The workflow**: Kick off the script after an event and let it run overnight. Wake up to a clean CSV ready for your CRM or email tool.
-This example focuses on LinkedIn but works across platforms. It uses [Cua Computer Framework](/computer/computers) to interact with web interfaces and [Agent Loops](/agent/agent-loops) to iterate through connections with conversation history.
+This example focuses on LinkedIn but works across platforms. It uses [Cua Computer Framework](/computer-sdk/computers) to interact with web interfaces and [Agent Loops](/agent-sdk/agent-loops) to iterate through connections with conversation history.
### Why Cua is Perfect for This
@@ -475,8 +475,8 @@ This script demonstrates a practical workflow for extracting LinkedIn connection
## Next Steps
-- Learn more about [Cua Computer Framework](/computer/computers) and [Computer Commands](/computer/commands)
-- Read about [Agent Loops](/agent/agent-loops), [Tools](/agent/custom-tools), and [Supported Model Providers](/agent/supported-model-providers/)
-- Experiment with different [Models and Providers](/agent/supported-model-providers/)
+- Learn more about [Cua Computer Framework](/computer-sdk/computers) and [Computer Commands](/computer-sdk/commands)
+- Read about [Agent Loops](/agent-sdk/agent-loops), [Tools](/agent-sdk/custom-tools), and [Supported Model Providers](/agent-sdk/supported-model-providers/)
+- Experiment with different [Models and Providers](/agent-sdk/supported-model-providers/)
- Adapt this script for other platforms (Twitter/X, email extraction, etc.)
- Join our [Discord community](https://discord.com/invite/mVnXXpdE85) for help
diff --git a/docs/content/docs/example-usecases/windows-app-behind-vpn.mdx b/docs/content/docs/example-usecases/windows-app-behind-vpn.mdx
index 0ac6b817..7779a40f 100644
--- a/docs/content/docs/example-usecases/windows-app-behind-vpn.mdx
+++ b/docs/content/docs/example-usecases/windows-app-behind-vpn.mdx
@@ -616,8 +616,8 @@ If costs are higher than expected:
## Next Steps
-- **Explore Custom Tools**: Learn how to create [Custom Tools](/agent/custom-tools) for application-specific actions
-- **Implement Callbacks**: Add [Monitoring and Logging](/agent/callbacks) for production workflows
+- **Explore Custom Tools**: Learn how to create [Custom Tools](/agent-sdk/custom-tools) for application-specific actions
+- **Implement Callbacks**: Add [Monitoring and Logging](/agent-sdk/callbacks) for production workflows
- **Join community**: Get help in our [Discord](https://discord.com/invite/mVnXXpdE85)
---
@@ -626,4 +626,4 @@ If costs are higher than expected:
- [Form Filling](/example-usecases/form-filling) - Web form automation
- [Post-Event Contact Export](/example-usecases/post-event-contact-export) - Data extraction workflows
-- [Custom Tools](/agent/custom-tools) - Building application-specific functions
+- [Custom Tools](/agent-sdk/custom-tools) - Building application-specific functions
diff --git a/docs/content/docs/get-started/quickstart.mdx b/docs/content/docs/get-started/quickstart.mdx
index f6b35355..17e28985 100644
--- a/docs/content/docs/get-started/quickstart.mdx
+++ b/docs/content/docs/get-started/quickstart.mdx
@@ -619,7 +619,7 @@ Install Cua Computer Framework and verify your sandbox is working by performing
-Learn more about computers in the [Cua computers documentation](/computer/computers).
+Learn more about computers in the [Cua computers documentation](/computer-sdk/computers).
@@ -772,7 +772,7 @@ While you can build your own agent loop with any LLM, Cua Agent Framework is the
- `huggingface-local/*` - Local HuggingFace models
- And many more via LiteLLM
- See [Supported Models](/agent/supported-model-providers/) for the complete list.
+ See [Supported Models](/agent-sdk/supported-model-providers/) for the complete list.
@@ -927,17 +927,17 @@ While you can build your own agent loop with any LLM, Cua Agent Framework is the
-Learn more about agents in [Agent Loops](/agent/agent-loops) and available models in [Supported Models](/agent/supported-model-providers/).
+Learn more about agents in [Agent Loops](/agent-sdk/agent-loops) and available models in [Supported Models](/agent-sdk/supported-model-providers/).
### Next Steps
-- Explore [Cua Computer Framework Commands](/computer/commands) for more sandbox interactions
-- Learn about [Agent Loops](/agent/agent-loops) and advanced agent configuration
-- Check out [Custom Tools](/agent/custom-tools) to extend your agents
-- Review [Supported Model Providers](/agent/supported-model-providers/) for more LLM options
+- Explore [Cua Computer Framework Commands](/computer-sdk/commands) for more sandbox interactions
+- Learn about [Agent Loops](/agent-sdk/agent-loops) and advanced agent configuration
+- Check out [Custom Tools](/agent-sdk/custom-tools) to extend your agents
+- Review [Supported Model Providers](/agent-sdk/supported-model-providers/) for more LLM options
- Try the [Form Filling](/example-usecases/form-filling) example use case
- Join our [Discord community](https://discord.com/invite/cua-ai) for help and discussion
@@ -1080,4 +1080,4 @@ cua sb delete my-sandbox-abc123
---
-For running models locally, see [Running Models Locally](/agent/supported-model-providers/local-models). */}
+For running models locally, see [Running Models Locally](/agent-sdk/supported-model-providers/local-models). */}
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index b0dc572a..a60101dc 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -45,10 +45,10 @@ Check out our [tutorials](https://cua.ai/blog), [examples](https://github.com/tr
} href="/get-started/quickstart" title="Quickstart" />
-
} href="/agent/agent-loops" title="Agent Loops" />
+
} href="/agent-sdk/agent-loops" title="Agent Loops" />
}
- href="/computer/computers"
+ href="/computer-sdk/computers"
title="Cua Computer"
/>
Agent Loops
diff --git a/libs/lume/README.md b/libs/lume/README.md
index 4c044743..6ad3c480 100644
--- a/libs/lume/README.md
+++ b/libs/lume/README.md
@@ -55,11 +55,11 @@ To get set up with Lume for development, read [these instructions](Development.m
## Docs
-- [Installation](https://cua.ai/docs/lume/installation)
-- [Prebuilt Images](https://cua.ai/docs/lume/prebuilt-images)
-- [CLI Reference](https://cua.ai/docs/lume/cli-reference)
-- [HTTP API](https://cua.ai/docs/lume/http-api)
-- [FAQ](https://cua.ai/docs/lume/faq)
+- [Installation](https://cua.ai/docs/macos-vm-cli-playbook/lume/installation)
+- [Prebuilt Images](https://cua.ai/docs/macos-vm-cli-playbook/lume/prebuilt-images)
+- [CLI Reference](https://cua.ai/docs/macos-vm-cli-playbook/lume/cli-reference)
+- [HTTP API](https://cua.ai/docs/macos-vm-cli-playbook/lume/http-api)
+- [FAQ](https://cua.ai/docs/macos-vm-cli-playbook/lume/faq)
## Contributing
diff --git a/libs/lumier/README.md b/libs/lumier/README.md
index 6a2f8669..957a190c 100644
--- a/libs/lumier/README.md
+++ b/libs/lumier/README.md
@@ -58,14 +58,14 @@ docker run -it --rm \
After running the command above, you can access your macOS VM through a web browser (e.g., http://localhost:8006).
-> **Note:** With the basic setup above, your VM will be reset when you stop the container (ephemeral mode). This means any changes you make inside the macOS VM will be lost. See [the documentation](https://cua.ai/docs/lumier/docker) for how to save your VM state.
+> **Note:** With the basic setup above, your VM will be reset when you stop the container (ephemeral mode). This means any changes you make inside the macOS VM will be lost. See [the documentation](https://cua.ai/docs/macos-vm-cli-playbook/lumier/docker) for how to save your VM state.
## Docs
-- [Installation](https://cua.ai/docs/lumier/installation)
-- [Docker](https://cua.ai/docs/lumier/docker)
-- [Docker Compose](https://cua.ai/docs/lumier/docker-compose)
-- [Building Lumier](https://cua.ai/docs/lumier/building-lumier)
+- [Installation](https://cua.ai/docs/macos-vm-cli-playbook/lumier/installation)
+- [Docker](https://cua.ai/docs/macos-vm-cli-playbook/lumier/docker)
+- [Docker Compose](https://cua.ai/docs/macos-vm-cli-playbook/lumier/docker-compose)
+- [Building Lumier](https://cua.ai/docs/macos-vm-cli-playbook/lumier/building-lumier)
## Credits
diff --git a/libs/python/agent/README.md b/libs/python/agent/README.md
index 4a91ab6e..40b901a3 100644
--- a/libs/python/agent/README.md
+++ b/libs/python/agent/README.md
@@ -72,16 +72,16 @@ if __name__ == "__main__":
## Docs
-- [Agent Loops](https://cua.ai/docs/agent/agent-loops)
-- [Supported Agents](https://cua.ai/docs/agent/supported-agents/computer-use-agents)
-- [Supported Models](https://cua.ai/docs/agent/supported-model-providers)
-- [Chat History](https://cua.ai/docs/agent/chat-history)
-- [Callbacks](https://cua.ai/docs/agent/callbacks)
-- [Custom Tools](https://cua.ai/docs/agent/custom-tools)
-- [Custom Computer Handlers](https://cua.ai/docs/computer/custom-computer-handlers)
-- [Prompt Caching](https://cua.ai/docs/agent/prompt-caching)
-- [Usage Tracking](https://cua.ai/docs/agent/usage-tracking)
-- [Benchmarks](https://cua.ai/docs/agent/benchmarks)
+- [Agent Loops](https://cua.ai/docs/agent-sdk/agent-loops)
+- [Supported Agents](https://cua.ai/docs/agent-sdk/supported-agents/computer-use-agents)
+- [Supported Models](https://cua.ai/docs/agent-sdk/supported-model-providers)
+- [Chat History](https://cua.ai/docs/agent-sdk/chat-history)
+- [Callbacks](https://cua.ai/docs/agent-sdk/callbacks)
+- [Custom Tools](https://cua.ai/docs/agent-sdk/custom-tools)
+- [Custom Computer Handlers](https://cua.ai/docs/computer-sdk/custom-computer-handlers)
+- [Prompt Caching](https://cua.ai/docs/agent-sdk/prompt-caching)
+- [Usage Tracking](https://cua.ai/docs/agent-sdk/usage-tracking)
+- [Benchmarks](https://cua.ai/docs/agent-sdk/benchmarks)
## License
diff --git a/libs/python/computer-server/README.md b/libs/python/computer-server/README.md
index 35e389d3..7cf583b6 100644
--- a/libs/python/computer-server/README.md
+++ b/libs/python/computer-server/README.md
@@ -40,7 +40,7 @@ Refer to this notebook for a step-by-step guide on how to use the Computer-Use S
## Docs
-- [Commands](https://cua.ai/docs/computer/computer-server/Commands)
-- [REST-API](https://cua.ai/docs/computer/computer-server/REST-API)
-- [WebSocket-API](https://cua.ai/docs/computer/computer-server/WebSocket-API)
-- [Index](https://cua.ai/docs/computer/computer-server)
+- [Commands](https://cua.ai/docs/computer-sdk/computer-server/Commands)
+- [REST-API](https://cua.ai/docs/computer-sdk/computer-server/REST-API)
+- [WebSocket-API](https://cua.ai/docs/computer-sdk/computer-server/WebSocket-API)
+- [Index](https://cua.ai/docs/computer-sdk/computer-server)
diff --git a/libs/python/computer/README.md b/libs/python/computer/README.md
index 3324eaa1..d1179b63 100644
--- a/libs/python/computer/README.md
+++ b/libs/python/computer/README.md
@@ -68,7 +68,7 @@ Refer to this notebook for a step-by-step guide on how to use the Computer-Use I
## Docs
-- [Computers](https://cua.ai/docs/computer/computers)
-- [Commands](https://cua.ai/docs/computer/commands)
-- [Computer UI](https://cua.ai/docs/computer/computer-ui)
-- [Sandboxed Python](https://cua.ai/docs/computer/sandboxed-python)
+- [Computers](https://cua.ai/docs/computer-sdk/computers)
+- [Commands](https://cua.ai/docs/computer-sdk/commands)
+- [Computer UI](https://cua.ai/docs/computer-sdk/computer-ui)
+- [Sandboxed Python](https://cua.ai/docs/computer-sdk/sandboxed-python)
diff --git a/libs/python/mcp-server/README.md b/libs/python/mcp-server/README.md
index a676c284..8bba33ce 100644
--- a/libs/python/mcp-server/README.md
+++ b/libs/python/mcp-server/README.md
@@ -129,12 +129,12 @@ See [desktop-extension/README.md](desktop-extension/README.md) for more details.
## Documentation
-- Installation: https://cua.ai/docs/mcp/installation
-- Configuration: https://cua.ai/docs/mcp/configuration
-- Usage: https://cua.ai/docs/mcp/usage
-- Tools: https://cua.ai/docs/mcp/tools
-- Client Integrations: https://cua.ai/docs/mcp/client-integrations
-- LLM Integrations: https://cua.ai/docs/mcp/llm-integrations
+- Installation: https://cua.ai/docs/agent-sdk/mcp-server/installation
+- Configuration: https://cua.ai/docs/agent-sdk/mcp-server/configuration
+- Usage: https://cua.ai/docs/agent-sdk/mcp-server/usage
+- Tools: https://cua.ai/docs/agent-sdk/mcp-server/tools
+- Client Integrations: https://cua.ai/docs/agent-sdk/mcp-server/client-integrations
+- LLM Integrations: https://cua.ai/docs/agent-sdk/mcp-server/llm-integrations
## Troubleshooting
diff --git a/libs/typescript/computer/README.md b/libs/typescript/computer/README.md
index 0ae0dbf2..782d5780 100644
--- a/libs/typescript/computer/README.md
+++ b/libs/typescript/computer/README.md
@@ -76,9 +76,9 @@ Refer to this example for a step-by-step guide on how to use the Computer-Use In
## Docs
-- [Computers](https://cua.ai/docs/computer/computers)
-- [Commands](https://cua.ai/docs/computer/commands)
-- [Computer UI](https://cua.ai/docs/computer/computer-ui)
+- [Computers](https://cua.ai/docs/computer-sdk/computers)
+- [Commands](https://cua.ai/docs/computer-sdk/commands)
+- [Computer UI](https://cua.ai/docs/computer-sdk/computer-ui)
## License