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.

Revert "refractor docs into 6 sections"

Adam5631c69af99c
diff --git a/README.md b/README.md
index 93412ad9ac..56c2558e25 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 3999bc6751..158495e07c 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 6d1a923dc4..7bfcbdea35 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 fe1f836ec3..43d76ab57d 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 62ca56ff02..f5ccb9baee 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 5048a19f86..d65fc64466 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
<Tabs items={['Claude Desktop', 'Other MCP Clients']}>
<Tab value="Claude Desktop">
- 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 ce3f6421d6..6bb01b62c7 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 7b3d5fafe6..74371087d8 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 19dd93fdb5..d09cfe9f92 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 90abee4486..d27aab31dd 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 089f0980d1..d123221c6b 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 5c2e5e4527..4fc7b0ffdb 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 5788a2698a..83d06b59b9 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 42092cef61..d133aa026f 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 a0297e9774..4a3d1d0fbc 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 e16df032e4..7eaef59662 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 0ac6b81769..7779a40fed 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 f6b3535520..17e2898556 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
</Tab>
</Tabs>
-Learn more about computers in the [Cua computers documentation](/computer/computers).
+Learn more about computers in the [Cua computers documentation](/computer-sdk/computers).
</Step>
@@ -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.
</Tab>
</Tabs>
@@ -927,17 +927,17 @@ While you can build your own agent loop with any LLM, Cua Agent Framework is the
</Tab>
</Tabs>
-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/).
</Step>
</Steps>
### 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 b0dc572ae0..a60101dcdc 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
<div className="grid grid-cols-2 md:grid-cols-4 gap-2 mt-4 text-sm">
<Card icon={<Rocket className="w-4 h-4" />} href="/get-started/quickstart" title="Quickstart" />
- <Card icon={<Zap className="w-4 h-4" />} href="/agent/agent-loops" title="Agent Loops" />
+ <Card icon={<Zap className="w-4 h-4" />} href="/agent-sdk/agent-loops" title="Agent Loops" />
<Card
icon={<BookOpen className="w-4 h-4" />}
- href="/computer/computers"
+ href="/computer-sdk/computers"
title="Cua Computer"
/>
<Card
diff --git a/docs/content/docs/lume/meta.json b/docs/content/docs/lume/meta.json
deleted file mode 100644
index 6ce0ffbbcd..0000000000
--- a/docs/content/docs/lume/meta.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
- "title": "Lume",
- "description": "VM management for macOS",
- "pages": ["index", "installation", "prebuilt-images", "cli-reference", "http-api", "faq"]
-}
diff --git a/docs/content/docs/lumier/meta.json b/docs/content/docs/lumier/meta.json
deleted file mode 100644
index 602387e124..0000000000
--- a/docs/content/docs/lumier/meta.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
- "title": "Lumier",
- "description": "Docker interface for macOS/Linux VMs",
- "pages": ["index", "installation", "docker", "docker-compose", "building-lumier"]
-}
diff --git a/docs/content/docs/lume/cli-reference.mdx b/docs/content/docs/macos-vm-cli-playbook/lume/cli-reference.mdx
similarity index 100%
rename from docs/content/docs/lume/cli-reference.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lume/cli-reference.mdx
diff --git a/docs/content/docs/lume/faq.md b/docs/content/docs/macos-vm-cli-playbook/lume/faq.md
similarity index 100%
rename from docs/content/docs/lume/faq.md
rename to docs/content/docs/macos-vm-cli-playbook/lume/faq.md
diff --git a/docs/content/docs/lume/http-api.mdx b/docs/content/docs/macos-vm-cli-playbook/lume/http-api.mdx
similarity index 100%
rename from docs/content/docs/lume/http-api.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lume/http-api.mdx
diff --git a/docs/content/docs/lume/index.mdx b/docs/content/docs/macos-vm-cli-playbook/lume/index.mdx
similarity index 100%
rename from docs/content/docs/lume/index.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lume/index.mdx
diff --git a/docs/content/docs/lume/installation.mdx b/docs/content/docs/macos-vm-cli-playbook/lume/installation.mdx
similarity index 100%
rename from docs/content/docs/lume/installation.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lume/installation.mdx
diff --git a/docs/content/docs/macos-vm-cli-playbook/lume/meta.json b/docs/content/docs/macos-vm-cli-playbook/lume/meta.json
new file mode 100644
index 0000000000..42aeac1d01
--- /dev/null
+++ b/docs/content/docs/macos-vm-cli-playbook/lume/meta.json
@@ -0,0 +1,3 @@
+{
+ "pages": ["installation", "prebuilt-images", "cli-reference", "http-api", "faq"]
+}
diff --git a/docs/content/docs/lume/prebuilt-images.mdx b/docs/content/docs/macos-vm-cli-playbook/lume/prebuilt-images.mdx
similarity index 100%
rename from docs/content/docs/lume/prebuilt-images.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lume/prebuilt-images.mdx
diff --git a/docs/content/docs/lumier/building-lumier.mdx b/docs/content/docs/macos-vm-cli-playbook/lumier/building-lumier.mdx
similarity index 100%
rename from docs/content/docs/lumier/building-lumier.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lumier/building-lumier.mdx
diff --git a/docs/content/docs/lumier/docker-compose.mdx b/docs/content/docs/macos-vm-cli-playbook/lumier/docker-compose.mdx
similarity index 100%
rename from docs/content/docs/lumier/docker-compose.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lumier/docker-compose.mdx
diff --git a/docs/content/docs/lumier/docker.mdx b/docs/content/docs/macos-vm-cli-playbook/lumier/docker.mdx
similarity index 100%
rename from docs/content/docs/lumier/docker.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lumier/docker.mdx
diff --git a/docs/content/docs/lumier/index.mdx b/docs/content/docs/macos-vm-cli-playbook/lumier/index.mdx
similarity index 100%
rename from docs/content/docs/lumier/index.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lumier/index.mdx
diff --git a/docs/content/docs/lumier/installation.mdx b/docs/content/docs/macos-vm-cli-playbook/lumier/installation.mdx
similarity index 100%
rename from docs/content/docs/lumier/installation.mdx
rename to docs/content/docs/macos-vm-cli-playbook/lumier/installation.mdx
diff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/meta.json b/docs/content/docs/macos-vm-cli-playbook/lumier/meta.json
new file mode 100644
index 0000000000..bfe2572455
--- /dev/null
+++ b/docs/content/docs/macos-vm-cli-playbook/lumier/meta.json
@@ -0,0 +1,3 @@
+{
+ "pages": ["installation", "docker", "docker-compose", "building-lumier"]
+}
diff --git a/docs/content/docs/macos-vm-cli-playbook/meta.json b/docs/content/docs/macos-vm-cli-playbook/meta.json
new file mode 100644
index 0000000000..a9c98b66d8
--- /dev/null
+++ b/docs/content/docs/macos-vm-cli-playbook/meta.json
@@ -0,0 +1,5 @@
+{
+ "title": "macOS VM CLI",
+ "description": "CLI tools for macOS virtualization",
+ "pages": ["lume", "lumier"]
+}
diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.json
index fa93d1e67a..14f80e9ed3 100644
--- a/docs/content/docs/meta.json
+++ b/docs/content/docs/meta.json
@@ -10,19 +10,13 @@
"...get-started",
"---[ChefHat]Examples Cookbook---",
"...example-usecases",
- "---[Bot]Agent---",
- "...agent",
- "---[BookCopy]Computer---",
- "...computer",
- "---[Terminal]Lume---",
- "...lume",
- "---[Terminal]Lumier---",
- "...lumier",
- "---[Target]Set-of-Mark---",
- "...som",
- "---[Plug]MCP---",
- "...mcp",
+ "---[Bot]Agent Playbook---",
+ "...agent-sdk",
+ "---[BookCopy]Computer Playbook---",
+ "...computer-sdk",
"---[Terminal]Cloud CLI Playbook---",
- "...cli-playbook"
+ "...cli-playbook",
+ "---[Terminal]macOS VM CLI Playbook---",
+ "...macos-vm-cli-playbook"
]
}
diff --git a/docs/content/docs/som/index.mdx b/docs/content/docs/som/index.mdx
deleted file mode 100644
index cc68c65164..0000000000
--- a/docs/content/docs/som/index.mdx
+++ /dev/null
@@ -1,82 +0,0 @@
----
-title: Set-of-Mark
-description: Set-of-Mark library for Agent
----
-
-**Set-of-Mark (SOM)** is a visual grounding component for the Computer-Use Agent (CUA) framework powering Cua, for detecting and analyzing UI elements in screenshots. Optimized for macOS Silicon with Metal Performance Shaders (MPS), it combines YOLO-based icon detection with EasyOCR text recognition to provide comprehensive UI element analysis.
-
-## Features
-
-- Optimized for Apple Silicon with MPS acceleration
-- Icon detection using YOLO with multi-scale processing
-- Text recognition using EasyOCR (GPU-accelerated)
-- Automatic hardware detection (MPS → CUDA → CPU)
-- Smart detection parameters tuned for UI elements
-- Detailed visualization with numbered annotations
-- Performance benchmarking tools
-
-## System Requirements
-
-- **Recommended**: macOS with Apple Silicon
- - Uses Metal Performance Shaders (MPS)
- - Multi-scale detection enabled
- - ~0.4s average detection time
-- **Supported**: Any Python 3.11+ environment
- - Falls back to CPU if no GPU available
- - Single-scale detection on CPU
- - ~1.3s average detection time
-
-## Installation
-
-```bash
-pip install cua-som
-```
-
-Or install with the Agent SDK:
-
-```bash
-pip install "cua-agent[omni]"
-```
-
-## Quick Start
-
-```python
-from som import OmniParser
-from PIL import Image
-
-# Initialize parser
-parser = OmniParser()
-
-# Process an image
-image = Image.open("screenshot.png")
-result = parser.parse(
- image,
- box_threshold=0.3, # Confidence threshold
- iou_threshold=0.1, # Overlap threshold
- use_ocr=True # Enable text detection
-)
-
-# Access results
-for elem in result.elements:
- if elem.type == "icon":
- print(f"Icon: confidence={elem.confidence:.3f}, bbox={elem.bbox.coordinates}")
- else: # text
- print(f"Text: '{elem.content}', confidence={elem.confidence:.3f}")
-```
-
-## Usage with Agent
-
-Set-of-Mark is used by the Agent SDK's OmniParser loop for UI element detection. When using the OmniParser agent loop, Set-of-Mark is automatically used for grounding:
-
-```python
-from agent import ComputerAgent
-
-# OmniParser loop uses Set-of-Mark automatically
-agent = ComputerAgent(
- model="omniparser+anthropic/claude-sonnet-4-5-20250929",
- tools=[computer]
-)
-```
-
-See the [Agent documentation](/agent/supported-agents/grounding-models) for more details on using Set-of-Mark with agents.
-
diff --git a/docs/content/docs/som/meta.json b/docs/content/docs/som/meta.json
deleted file mode 100644
index 0ccff84e47..0000000000
--- a/docs/content/docs/som/meta.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
- "title": "Set-of-Mark",
- "description": "Set-of-Mark library for Agent",
- "pages": ["index"]
-}
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
index 192aaeab02..fdb996c11f 100644
--- a/docs/next.config.mjs
+++ b/docs/next.config.mjs
@@ -45,10 +45,10 @@ const config = {
destination: '/get-started/quickstart',
permanent: true,
},
- // Moved telemetry to agent section
+ // Moved telemetry to agent-sdk section
{
source: '/telemetry',
- destination: '/agent/telemetry',
+ destination: '/agent-sdk/telemetry',
permanent: true,
},
// Removed quickstart-cli, consolidated into main quickstart
@@ -57,37 +57,6 @@ const config = {
destination: '/get-started/quickstart',
permanent: true,
},
- // Documentation restructure: 6-section organization
- // Redirect old agent-sdk paths to new agent paths
- {
- source: '/agent-sdk/:path*',
- destination: '/agent/:path*',
- permanent: true,
- },
- // Redirect old computer-sdk paths to new computer paths
- {
- source: '/computer-sdk/:path*',
- destination: '/computer/:path*',
- permanent: true,
- },
- // Redirect old macos-vm-cli-playbook/lume paths to new lume paths
- {
- source: '/macos-vm-cli-playbook/lume/:path*',
- destination: '/lume/:path*',
- permanent: true,
- },
- // Redirect old macos-vm-cli-playbook/lumier paths to new lumier paths
- {
- source: '/macos-vm-cli-playbook/lumier/:path*',
- destination: '/lumier/:path*',
- permanent: true,
- },
- // Redirect old agent-sdk/mcp-server paths to new mcp paths
- {
- source: '/agent-sdk/mcp-server/:path*',
- destination: '/mcp/:path*',
- permanent: true,
- },
];
},
images: {
diff --git a/docs/src/components/footer.tsx b/docs/src/components/footer.tsx
index c21a392549..02f3a9eaf1 100644
--- a/docs/src/components/footer.tsx
+++ b/docs/src/components/footer.tsx
@@ -48,7 +48,7 @@ export function Footer() {
</li>
<li>
<a
- href="/docs/agent/agent-loops"
+ href="/docs/agent-sdk/agent-loops"
className="text-sm text-fd-muted-foreground hover:text-fd-foreground transition-colors"
>
Agent Loops
diff --git a/libs/lume/README.md b/libs/lume/README.md
index 4c04474385..6ad3c4806d 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 6a2f866971..957a190cc0 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 4a91ab6eaf..40b901a38e 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 35e389d39f..7cf583b673 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 3324eaa10b..d1179b634b 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 a676c28402..8bba33ceff 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 0ae0dbf2e0..782d5780a6 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