Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
refractor docs into 6 sections
Adam13f3fb800d09
diff --git a/README.md b/README.mdindex 56c2558e25..3d77d0199c 100644--- a/README.md+++ b/README.md@@ -32,14 +32,14 @@ Computer-Use Agents (CUAs) are AI systems that can autonomously interact with coWith the [Computer SDK](#computer-sdk), you can:-- automate Windows, Linux, and macOS VMs with a consistent, [pyautogui-like API](https://cua.ai/docs/computer-sdk/commands)+- automate Windows, Linux, and macOS VMs with a consistent, [pyautogui-like API](https://cua.ai/docs/computer/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-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)+- 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)- 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))@@ -211,9 +211,9 @@ 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-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 |+| `{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 |### 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-sdk/supported-agents/composed-agents).+See more examples on our [composition docs](https://cua.ai/docs/agent/supported-agents/composed-agents).```python# Use OpenAI's GPT-5 for planning with specialized groundingdiff --git a/docs/content/docs/agent-sdk/agent-loops.mdx b/docs/content/docs/agent/agent-loops.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/agent-loops.mdxrename to docs/content/docs/agent/agent-loops.mdxdiff --git a/docs/content/docs/agent-sdk/benchmarks/index.mdx b/docs/content/docs/agent/benchmarks/index.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/index.mdxrename to docs/content/docs/agent/benchmarks/index.mdxdiff --git a/docs/content/docs/agent-sdk/benchmarks/interactive.mdx b/docs/content/docs/agent/benchmarks/interactive.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/interactive.mdxrename to docs/content/docs/agent/benchmarks/interactive.mdxdiff --git a/docs/content/docs/agent-sdk/benchmarks/introduction.mdx b/docs/content/docs/agent/benchmarks/introduction.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/introduction.mdxrename to docs/content/docs/agent/benchmarks/introduction.mdxdiff --git a/docs/content/docs/agent-sdk/benchmarks/meta.json b/docs/content/docs/agent/benchmarks/meta.jsonsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/meta.jsonrename to docs/content/docs/agent/benchmarks/meta.jsondiff --git a/docs/content/docs/agent-sdk/benchmarks/osworld-verified.mdx b/docs/content/docs/agent/benchmarks/osworld-verified.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/osworld-verified.mdxrename to docs/content/docs/agent/benchmarks/osworld-verified.mdxdiff --git a/docs/content/docs/agent-sdk/benchmarks/screenspot-pro.mdx b/docs/content/docs/agent/benchmarks/screenspot-pro.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/screenspot-pro.mdxrename to docs/content/docs/agent/benchmarks/screenspot-pro.mdxdiff --git a/docs/content/docs/agent-sdk/benchmarks/screenspot-v2.mdx b/docs/content/docs/agent/benchmarks/screenspot-v2.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/benchmarks/screenspot-v2.mdxrename to docs/content/docs/agent/benchmarks/screenspot-v2.mdxdiff --git a/docs/content/docs/agent-sdk/callbacks/agent-lifecycle.mdx b/docs/content/docs/agent/callbacks/agent-lifecycle.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/agent-lifecycle.mdxrename to docs/content/docs/agent/callbacks/agent-lifecycle.mdxdiff --git a/docs/content/docs/agent-sdk/callbacks/cost-saving.mdx b/docs/content/docs/agent/callbacks/cost-saving.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/cost-saving.mdxrename to docs/content/docs/agent/callbacks/cost-saving.mdxdiff --git a/docs/content/docs/agent-sdk/callbacks/index.mdx b/docs/content/docs/agent/callbacks/index.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/index.mdxrename to docs/content/docs/agent/callbacks/index.mdxdiff --git a/docs/content/docs/agent-sdk/callbacks/logging.mdx b/docs/content/docs/agent/callbacks/logging.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/logging.mdxrename to docs/content/docs/agent/callbacks/logging.mdxdiff --git a/docs/content/docs/agent-sdk/callbacks/meta.json b/docs/content/docs/agent/callbacks/meta.jsonsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/meta.jsonrename to docs/content/docs/agent/callbacks/meta.jsondiff --git a/docs/content/docs/agent-sdk/callbacks/pii-anonymization.mdx b/docs/content/docs/agent/callbacks/pii-anonymization.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/pii-anonymization.mdxrename to docs/content/docs/agent/callbacks/pii-anonymization.mdxdiff --git a/docs/content/docs/agent-sdk/callbacks/trajectories.mdx b/docs/content/docs/agent/callbacks/trajectories.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/callbacks/trajectories.mdxrename to docs/content/docs/agent/callbacks/trajectories.mdxdiff --git a/docs/content/docs/agent-sdk/chat-history.mdx b/docs/content/docs/agent/chat-history.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/chat-history.mdxrename to docs/content/docs/agent/chat-history.mdxdiff --git a/docs/content/docs/agent-sdk/custom-tools.mdx b/docs/content/docs/agent/custom-tools.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/custom-tools.mdxrename to docs/content/docs/agent/custom-tools.mdxdiff --git a/docs/content/docs/agent-sdk/customizing-computeragent.mdx b/docs/content/docs/agent/customizing-computeragent.mdxsimilarity index 96%rename from docs/content/docs/agent-sdk/customizing-computeragent.mdxrename to docs/content/docs/agent/customizing-computeragent.mdxindex 158495e07c..3999bc6751 100644--- a/docs/content/docs/agent-sdk/customizing-computeragent.mdx+++ b/docs/content/docs/agent/customizing-computeragent.mdx@@ -63,8 +63,8 @@ agent = ComputerAgent()```-- See `docs/agent-sdk/custom-tools` for authoring function tools.-- See `docs/agent-sdk/custom-computer-handlers` for building full computer interfaces.+- See `docs/agent/custom-tools` for authoring function tools.+- See `docs/computer/custom-computer-handlers` for building full computer interfaces.## 3) Intermediate: Callbacksdiff --git a/docs/content/docs/agent-sdk/integrations/hud.mdx b/docs/content/docs/agent/integrations/hud.mdxsimilarity index 97%rename from docs/content/docs/agent-sdk/integrations/hud.mdxrename to docs/content/docs/agent/integrations/hud.mdxindex 7bfcbdea35..6d1a923dc4 100644--- a/docs/content/docs/agent-sdk/integrations/hud.mdx+++ b/docs/content/docs/agent/integrations/hud.mdx@@ -125,7 +125,7 @@ Both single-task and full-dataset runs share a common set of configuration optioHUD provides multiple benchmark datasets for realistic evaluation.-1. **[OSWorld-Verified](/agent-sdk/benchmarks/osworld-verified)** – Benchmark on 369+ real-world desktop tasks across Chrome, LibreOffice, GIMP, VS Code, etc.+1. **[OSWorld-Verified](/agent/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-sdk/integrations/meta.json b/docs/content/docs/agent/integrations/meta.jsonsimilarity index 100%rename from docs/content/docs/agent-sdk/integrations/meta.jsonrename to docs/content/docs/agent/integrations/meta.jsondiff --git a/docs/content/docs/agent-sdk/integrations/observability.mdx b/docs/content/docs/agent/integrations/observability.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/integrations/observability.mdxrename to docs/content/docs/agent/integrations/observability.mdxdiff --git a/docs/content/docs/agent-sdk/message-format.mdx b/docs/content/docs/agent/message-format.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/message-format.mdxrename to docs/content/docs/agent/message-format.mdxdiff --git a/docs/content/docs/agent-sdk/meta.json b/docs/content/docs/agent/meta.jsonsimilarity index 85%rename from docs/content/docs/agent-sdk/meta.jsonrename to docs/content/docs/agent/meta.jsonindex 6bb01b62c7..ce3f6421d6 100644--- a/docs/content/docs/agent-sdk/meta.json+++ b/docs/content/docs/agent/meta.json@@ -1,5 +1,5 @@{- "title": "Agent SDK",+ "title": "Agent","description": "Build computer-using agents with the Agent SDK","pages": ["agent-loops",@@ -14,7 +14,6 @@"usage-tracking","telemetry","benchmarks",- "integrations",- "mcp-server"+ "integrations"]}diff --git a/docs/content/docs/agent-sdk/migration-guide.mdx b/docs/content/docs/agent/migration-guide.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/migration-guide.mdxrename to docs/content/docs/agent/migration-guide.mdxdiff --git a/docs/content/docs/agent-sdk/prompt-caching.mdx b/docs/content/docs/agent/prompt-caching.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/prompt-caching.mdxrename to docs/content/docs/agent/prompt-caching.mdxdiff --git a/docs/content/docs/agent-sdk/supported-agents/composed-agents.mdx b/docs/content/docs/agent/supported-agents/composed-agents.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/supported-agents/composed-agents.mdxrename to docs/content/docs/agent/supported-agents/composed-agents.mdxdiff --git a/docs/content/docs/agent-sdk/supported-agents/computer-use-agents.mdx b/docs/content/docs/agent/supported-agents/computer-use-agents.mdxsimilarity index 95%rename from docs/content/docs/agent-sdk/supported-agents/computer-use-agents.mdxrename to docs/content/docs/agent/supported-agents/computer-use-agents.mdxindex 74371087d8..7b3d5fafe6 100644--- a/docs/content/docs/agent-sdk/supported-agents/computer-use-agents.mdx+++ b/docs/content/docs/agent/supported-agents/computer-use-agents.mdx@@ -7,7 +7,7 @@ These models support complete computer-use agent functionality through `ComputerAll agent loops are compatible with any LLM provider supported by LiteLLM.-See [Running Models Locally](/agent-sdk/supported-model-providers/local-models) for how to use Hugging Face and MLX models on your own machine.+See [Running Models Locally](/agent/supported-model-providers/local-models) for how to use Hugging Face and MLX models on your own machine.## Gemini CUAdiff --git a/docs/content/docs/agent-sdk/supported-agents/grounding-models.mdx b/docs/content/docs/agent/supported-agents/grounding-models.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/supported-agents/grounding-models.mdxrename to docs/content/docs/agent/supported-agents/grounding-models.mdxdiff --git a/docs/content/docs/agent-sdk/supported-agents/human-in-the-loop.mdx b/docs/content/docs/agent/supported-agents/human-in-the-loop.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/supported-agents/human-in-the-loop.mdxrename to docs/content/docs/agent/supported-agents/human-in-the-loop.mdxdiff --git a/docs/content/docs/agent-sdk/supported-agents/meta.json b/docs/content/docs/agent/supported-agents/meta.jsonsimilarity index 100%rename from docs/content/docs/agent-sdk/supported-agents/meta.jsonrename to docs/content/docs/agent/supported-agents/meta.jsondiff --git a/docs/content/docs/agent-sdk/supported-model-providers/cua-vlm-router.mdx b/docs/content/docs/agent/supported-model-providers/cua-vlm-router.mdxsimilarity index 96%rename from docs/content/docs/agent-sdk/supported-model-providers/cua-vlm-router.mdxrename to docs/content/docs/agent/supported-model-providers/cua-vlm-router.mdxindex d09cfe9f92..19dd93fdb5 100644--- a/docs/content/docs/agent-sdk/supported-model-providers/cua-vlm-router.mdx+++ b/docs/content/docs/agent/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-sdk/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/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-sdk/agent-loops) to customize agent behavior-- Learn about [Cost Saving Callbacks](/agent-sdk/callbacks/cost-saving)+- Explore [Agent Loops](/agent/agent-loops) to customize agent behavior+- Learn about [Cost Saving Callbacks](/agent/callbacks/cost-saving)- Try [Example Use Cases](/example-usecases/form-filling)-- Review [Supported Model Providers](/agent-sdk/supported-model-providers/) for all options+- Review [Supported Model Providers](/agent/supported-model-providers/) for all optionsdiff --git a/docs/content/docs/agent-sdk/supported-model-providers/index.mdx b/docs/content/docs/agent/supported-model-providers/index.mdxsimilarity index 97%rename from docs/content/docs/agent-sdk/supported-model-providers/index.mdxrename to docs/content/docs/agent/supported-model-providers/index.mdxindex d27aab31dd..90abee4486 100644--- a/docs/content/docs/agent-sdk/supported-model-providers/index.mdx+++ b/docs/content/docs/agent/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-sdk/supported-model-providers/cua-vlm-router)+[Learn more about Cua VLM Router →](/agent/supported-model-providers/cua-vlm-router)---diff --git a/docs/content/docs/agent-sdk/supported-model-providers/local-models.mdx b/docs/content/docs/agent/supported-model-providers/local-models.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/supported-model-providers/local-models.mdxrename to docs/content/docs/agent/supported-model-providers/local-models.mdxdiff --git a/docs/content/docs/agent-sdk/telemetry.mdx b/docs/content/docs/agent/telemetry.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/telemetry.mdxrename to docs/content/docs/agent/telemetry.mdxdiff --git a/docs/content/docs/agent-sdk/usage-tracking.mdx b/docs/content/docs/agent/usage-tracking.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/usage-tracking.mdxrename to docs/content/docs/agent/usage-tracking.mdxdiff --git a/docs/content/docs/cli-playbook/commands.mdx b/docs/content/docs/cli-playbook/commands.mdxindex d123221c6b..089f0980d1 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-sdk/computers)-- [Explore agent automation](/agent-sdk/agent-loops)+- [Learn about CUA computers](/computer/computers)+- [Explore agent automation](/agent/agent-loops)diff --git a/docs/content/docs/computer-sdk/cloud-vm-management.mdx b/docs/content/docs/computer/cloud-vm-management.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/cloud-vm-management.mdxrename to docs/content/docs/computer/cloud-vm-management.mdxdiff --git a/docs/content/docs/computer-sdk/commands.mdx b/docs/content/docs/computer/commands.mdxsimilarity index 98%rename from docs/content/docs/computer-sdk/commands.mdxrename to docs/content/docs/computer/commands.mdxindex 4fc7b0ffdb..5c2e5e4527 100644--- a/docs/content/docs/computer-sdk/commands.mdx+++ b/docs/content/docs/computer/commands.mdx@@ -5,7 +5,7 @@ description: Computer commands and interface methodsThis 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-sdk/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/computer-server/Commands), and provide low-level, async access to system operations from your agent or automation code.## Shell Actionsdiff --git a/docs/content/docs/computer-sdk/computer-server/Commands.mdx b/docs/content/docs/computer/computer-server/Commands.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/computer-server/Commands.mdxrename to docs/content/docs/computer/computer-server/Commands.mdxdiff --git a/docs/content/docs/computer-sdk/computer-server/REST-API.mdx b/docs/content/docs/computer/computer-server/REST-API.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/computer-server/REST-API.mdxrename to docs/content/docs/computer/computer-server/REST-API.mdxdiff --git a/docs/content/docs/computer-sdk/computer-server/WebSocket-API.mdx b/docs/content/docs/computer/computer-server/WebSocket-API.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/computer-server/WebSocket-API.mdxrename to docs/content/docs/computer/computer-server/WebSocket-API.mdxdiff --git a/docs/content/docs/computer-sdk/computer-server/index.mdx b/docs/content/docs/computer/computer-server/index.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/computer-server/index.mdxrename to docs/content/docs/computer/computer-server/index.mdxdiff --git a/docs/content/docs/computer-sdk/computer-server/meta.json b/docs/content/docs/computer/computer-server/meta.jsonsimilarity index 100%rename from docs/content/docs/computer-sdk/computer-server/meta.jsonrename to docs/content/docs/computer/computer-server/meta.jsondiff --git a/docs/content/docs/computer-sdk/computer-ui.mdx b/docs/content/docs/computer/computer-ui.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/computer-ui.mdxrename to docs/content/docs/computer/computer-ui.mdxdiff --git a/docs/content/docs/computer-sdk/computers.mdx b/docs/content/docs/computer/computers.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/computers.mdxrename to docs/content/docs/computer/computers.mdxdiff --git a/docs/content/docs/computer-sdk/custom-computer-handlers.mdx b/docs/content/docs/computer/custom-computer-handlers.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/custom-computer-handlers.mdxrename to docs/content/docs/computer/custom-computer-handlers.mdxdiff --git a/docs/content/docs/computer-sdk/meta.json b/docs/content/docs/computer/meta.jsonsimilarity index 89%rename from docs/content/docs/computer-sdk/meta.jsonrename to docs/content/docs/computer/meta.jsonindex 83d06b59b9..5788a2698a 100644--- a/docs/content/docs/computer-sdk/meta.json+++ b/docs/content/docs/computer/meta.json@@ -1,5 +1,5 @@{- "title": "Computer SDK",+ "title": "Computer","description": "Build computer-using agents with the Computer SDK","pages": ["computers",diff --git a/docs/content/docs/computer-sdk/sandboxed-python.mdx b/docs/content/docs/computer/sandboxed-python.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/sandboxed-python.mdxrename to docs/content/docs/computer/sandboxed-python.mdxdiff --git a/docs/content/docs/computer-sdk/tracing-api.mdx b/docs/content/docs/computer/tracing-api.mdxsimilarity index 100%rename from docs/content/docs/computer-sdk/tracing-api.mdxrename to docs/content/docs/computer/tracing-api.mdxdiff --git a/docs/content/docs/example-usecases/form-filling.mdx b/docs/content/docs/example-usecases/form-filling.mdxindex d133aa026f..42092cef61 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-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.+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.---@@ -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-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/)+- 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/)- Join our [Discord community](https://discord.com/invite/mVnXXpdE85) for helpdiff --git a/docs/content/docs/example-usecases/gemini-complex-ui-navigation.mdx b/docs/content/docs/example-usecases/gemini-complex-ui-navigation.mdxindex 4a3d1d0fbc..a0297e9774 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-sdk/agent-loops)+- Learn more about [OmniParser agent loops](/agent/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.mdxindex 7eaef59662..e16df032e4 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-sdk/computers) to interact with web interfaces and [Agent Loops](/agent-sdk/agent-loops) to iterate through connections with conversation history.+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.### 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-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/)+- 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/)- Adapt this script for other platforms (Twitter/X, email extraction, etc.)- Join our [Discord community](https://discord.com/invite/mVnXXpdE85) for helpdiff --git a/docs/content/docs/example-usecases/windows-app-behind-vpn.mdx b/docs/content/docs/example-usecases/windows-app-behind-vpn.mdxindex 7779a40fed..0ac6b81769 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-sdk/custom-tools) for application-specific actions-- **Implement Callbacks**: Add [Monitoring and Logging](/agent-sdk/callbacks) for production workflows+- **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- **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-sdk/custom-tools) - Building application-specific functions+- [Custom Tools](/agent/custom-tools) - Building application-specific functionsdiff --git a/docs/content/docs/get-started/quickstart.mdx b/docs/content/docs/get-started/quickstart.mdxindex 17e2898556..f6b3535520 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-sdk/computers).+Learn more about computers in the [Cua computers documentation](/computer/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-sdk/supported-model-providers/) for the complete list.+ See [Supported Models](/agent/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-sdk/agent-loops) and available models in [Supported Models](/agent-sdk/supported-model-providers/).+Learn more about agents in [Agent Loops](/agent/agent-loops) and available models in [Supported Models](/agent/supported-model-providers/).</Step></Steps>### Next Steps-- 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+- 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- 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-sdk/supported-model-providers/local-models). */}+For running models locally, see [Running Models Locally](/agent/supported-model-providers/local-models). */}diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdxindex a60101dcdc..b0dc572ae0 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-sdk/agent-loops" title="Agent Loops" />+ <Card icon={<Zap className="w-4 h-4" />} href="/agent/agent-loops" title="Agent Loops" /><Cardicon={<BookOpen className="w-4 h-4" />}- href="/computer-sdk/computers"+ href="/computer/computers"title="Cua Computer"/><Carddiff --git a/docs/content/docs/macos-vm-cli-playbook/lume/cli-reference.mdx b/docs/content/docs/lume/cli-reference.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lume/cli-reference.mdxrename to docs/content/docs/lume/cli-reference.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lume/faq.md b/docs/content/docs/lume/faq.mdsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lume/faq.mdrename to docs/content/docs/lume/faq.mddiff --git a/docs/content/docs/macos-vm-cli-playbook/lume/http-api.mdx b/docs/content/docs/lume/http-api.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lume/http-api.mdxrename to docs/content/docs/lume/http-api.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lume/index.mdx b/docs/content/docs/lume/index.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lume/index.mdxrename to docs/content/docs/lume/index.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lume/installation.mdx b/docs/content/docs/lume/installation.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lume/installation.mdxrename to docs/content/docs/lume/installation.mdxdiff --git a/docs/content/docs/lume/meta.json b/docs/content/docs/lume/meta.jsonnew file mode 100644index 0000000000..96e39a6308--- /dev/null+++ b/docs/content/docs/lume/meta.json@@ -0,0 +1,12 @@+{+ "title": "Lume",+ "description": "VM management for macOS",+ "pages": [+ "index",+ "installation",+ "prebuilt-images",+ "cli-reference",+ "http-api",+ "faq"+ ]+}diff --git a/docs/content/docs/macos-vm-cli-playbook/lume/prebuilt-images.mdx b/docs/content/docs/lume/prebuilt-images.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lume/prebuilt-images.mdxrename to docs/content/docs/lume/prebuilt-images.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/building-lumier.mdx b/docs/content/docs/lumier/building-lumier.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lumier/building-lumier.mdxrename to docs/content/docs/lumier/building-lumier.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/docker-compose.mdx b/docs/content/docs/lumier/docker-compose.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lumier/docker-compose.mdxrename to docs/content/docs/lumier/docker-compose.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/docker.mdx b/docs/content/docs/lumier/docker.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lumier/docker.mdxrename to docs/content/docs/lumier/docker.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/index.mdx b/docs/content/docs/lumier/index.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lumier/index.mdxrename to docs/content/docs/lumier/index.mdxdiff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/installation.mdx b/docs/content/docs/lumier/installation.mdxsimilarity index 100%rename from docs/content/docs/macos-vm-cli-playbook/lumier/installation.mdxrename to docs/content/docs/lumier/installation.mdxdiff --git a/docs/content/docs/lumier/meta.json b/docs/content/docs/lumier/meta.jsonnew file mode 100644index 0000000000..0110ee3200--- /dev/null+++ b/docs/content/docs/lumier/meta.json@@ -0,0 +1,11 @@+{+ "title": "Lumier",+ "description": "Docker interface for macOS/Linux VMs",+ "pages": [+ "index",+ "installation",+ "docker",+ "docker-compose",+ "building-lumier"+ ]+}diff --git a/docs/content/docs/macos-vm-cli-playbook/lume/meta.json b/docs/content/docs/macos-vm-cli-playbook/lume/meta.jsondeleted file mode 100644index 42aeac1d01..0000000000--- a/docs/content/docs/macos-vm-cli-playbook/lume/meta.json+++ /dev/null@@ -1,3 +0,0 @@-{- "pages": ["installation", "prebuilt-images", "cli-reference", "http-api", "faq"]-}diff --git a/docs/content/docs/macos-vm-cli-playbook/lumier/meta.json b/docs/content/docs/macos-vm-cli-playbook/lumier/meta.jsondeleted file mode 100644index bfe2572455..0000000000--- a/docs/content/docs/macos-vm-cli-playbook/lumier/meta.json+++ /dev/null@@ -1,3 +0,0 @@-{- "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.jsondeleted file mode 100644index a9c98b66d8..0000000000--- a/docs/content/docs/macos-vm-cli-playbook/meta.json+++ /dev/null@@ -1,5 +0,0 @@-{- "title": "macOS VM CLI",- "description": "CLI tools for macOS virtualization",- "pages": ["lume", "lumier"]-}diff --git a/docs/content/docs/agent-sdk/mcp-server/client-integrations.mdx b/docs/content/docs/mcp/client-integrations.mdxsimilarity index 97%rename from docs/content/docs/agent-sdk/mcp-server/client-integrations.mdxrename to docs/content/docs/mcp/client-integrations.mdxindex 43d76ab57d..fe1f836ec3 100644--- a/docs/content/docs/agent-sdk/mcp-server/client-integrations.mdx+++ b/docs/content/docs/mcp/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](/docs/libraries/mcp-server/configuration) page for detailed configuration options.+See the [Configuration](/mcp/configuration) page for detailed configuration options.diff --git a/docs/content/docs/agent-sdk/mcp-server/configuration.mdx b/docs/content/docs/mcp/configuration.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/mcp-server/configuration.mdxrename to docs/content/docs/mcp/configuration.mdxdiff --git a/docs/content/docs/agent-sdk/mcp-server/index.mdx b/docs/content/docs/mcp/index.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/mcp-server/index.mdxrename to docs/content/docs/mcp/index.mdxdiff --git a/docs/content/docs/agent-sdk/mcp-server/installation.mdx b/docs/content/docs/mcp/installation.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/mcp-server/installation.mdxrename to docs/content/docs/mcp/installation.mdxdiff --git a/docs/content/docs/agent-sdk/mcp-server/llm-integrations.mdx b/docs/content/docs/mcp/llm-integrations.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/mcp-server/llm-integrations.mdxrename to docs/content/docs/mcp/llm-integrations.mdxdiff --git a/docs/content/docs/agent-sdk/mcp-server/meta.json b/docs/content/docs/mcp/meta.jsonsimilarity index 58%rename from docs/content/docs/agent-sdk/mcp-server/meta.jsonrename to docs/content/docs/mcp/meta.jsonindex f5ccb9baee..62ca56ff02 100644--- a/docs/content/docs/agent-sdk/mcp-server/meta.json+++ b/docs/content/docs/mcp/meta.json@@ -1,5 +1,8 @@{+ "title": "MCP",+ "description": "MCP server for using Cua agents and computers","pages": [+ "index","installation","configuration","usage",diff --git a/docs/content/docs/agent-sdk/mcp-server/tools.mdx b/docs/content/docs/mcp/tools.mdxsimilarity index 100%rename from docs/content/docs/agent-sdk/mcp-server/tools.mdxrename to docs/content/docs/mcp/tools.mdxdiff --git a/docs/content/docs/agent-sdk/mcp-server/usage.mdx b/docs/content/docs/mcp/usage.mdxsimilarity index 97%rename from docs/content/docs/agent-sdk/mcp-server/usage.mdxrename to docs/content/docs/mcp/usage.mdxindex d65fc64466..5048a19f86 100644--- a/docs/content/docs/agent-sdk/mcp-server/usage.mdx+++ b/docs/content/docs/mcp/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](/docs/libraries/mcp-server/installation)) to include the environment variable:+ Update your Claude Desktop config (see [Installation](/mcp/installation)) to include the environment variable:```json{diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.jsonindex 14f80e9ed3..fa93d1e67a 100644--- a/docs/content/docs/meta.json+++ b/docs/content/docs/meta.json@@ -10,13 +10,19 @@"...get-started","---[ChefHat]Examples Cookbook---","...example-usecases",- "---[Bot]Agent Playbook---",- "...agent-sdk",- "---[BookCopy]Computer Playbook---",- "...computer-sdk",+ "---[Bot]Agent---",+ "...agent",+ "---[BookCopy]Computer---",+ "...computer",+ "---[Terminal]Lume---",+ "...lume",+ "---[Terminal]Lumier---",+ "...lumier",+ "---[Target]Set-of-Mark---",+ "...som",+ "---[Plug]MCP---",+ "...mcp","---[Terminal]Cloud CLI Playbook---",- "...cli-playbook",- "---[Terminal]macOS VM CLI Playbook---",- "...macos-vm-cli-playbook"+ "...cli-playbook"]}diff --git a/docs/content/docs/som/index.mdx b/docs/content/docs/som/index.mdxnew file mode 100644index 0000000000..cc68c65164--- /dev/null+++ b/docs/content/docs/som/index.mdx@@ -0,0 +1,82 @@+---+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.jsonnew file mode 100644index 0000000000..3713147643--- /dev/null+++ b/docs/content/docs/som/meta.json@@ -0,0 +1,8 @@+{+ "title": "Set-of-Mark",+ "description": "Set-of-Mark library for Agent",+ "pages": [+ "index"+ ]+}+diff --git a/docs/next.config.mjs b/docs/next.config.mjsindex fdb996c11f..192aaeab02 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-sdk section+ // Moved telemetry to agent section{source: '/telemetry',- destination: '/agent-sdk/telemetry',+ destination: '/agent/telemetry',permanent: true,},// Removed quickstart-cli, consolidated into main quickstart@@ -57,6 +57,37 @@ 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.tsxindex 02f3a9eaf1..c21a392549 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-sdk/agent-loops"+ href="/docs/agent/agent-loops"className="text-sm text-fd-muted-foreground hover:text-fd-foreground transition-colors">Agent Loopsdiff --git a/libs/lume/README.md b/libs/lume/README.mdindex 6ad3c4806d..4c04474385 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/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)+- [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)## Contributingdiff --git a/libs/lumier/README.md b/libs/lumier/README.mdindex 957a190cc0..6a2f866971 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/macos-vm-cli-playbook/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/lumier/docker) for how to save your VM state.## Docs-- [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)+- [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)## Creditsdiff --git a/libs/python/agent/README.md b/libs/python/agent/README.mdindex 40b901a38e..4a91ab6eaf 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-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)+- [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)## Licensediff --git a/libs/python/computer-server/README.md b/libs/python/computer-server/README.mdindex 7cf583b673..35e389d39f 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-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)+- [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)diff --git a/libs/python/computer/README.md b/libs/python/computer/README.mdindex d1179b634b..3324eaa10b 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-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)+- [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)diff --git a/libs/python/mcp-server/README.md b/libs/python/mcp-server/README.mdindex 8bba33ceff..a676c28402 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/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+- 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## Troubleshootingdiff --git a/libs/typescript/computer/README.md b/libs/typescript/computer/README.mdindex 782d5780a6..0ae0dbf2e0 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-sdk/computers)-- [Commands](https://cua.ai/docs/computer-sdk/commands)-- [Computer UI](https://cua.ai/docs/computer-sdk/computer-ui)+- [Computers](https://cua.ai/docs/computer/computers)+- [Commands](https://cua.ai/docs/computer/commands)+- [Computer UI](https://cua.ai/docs/computer/computer-ui)## License