OpenHands · xingyaoww · Oct 21, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,6 @@
+# Local checkout of agent-sdk for docs workflows and local testing
+agent-sdk/
+
+# OS junk
+.DS_Store
+Thumbs.db
diff --git a/agent-sdk b/agent-sdk
diff --git a/docs.json b/docs.json
@@ -224,25 +224,29 @@
         ]
       },
       {
-          "tab": "API Reference",
+          "tab": "OpenHands (Core) API",
           "openapi": "openapi/openapi.json"
+      },
+      {
+          "tab": "Agent SDK (API)",
+          "openapi": "openapi/agent-sdk.json"
       }
     ],
     "global": {
       "anchors": [
         {
           "anchor": "Company",
-          "href": "https://www.all-hands.dev/",
+          "href": "https://openhands.dev/",
           "icon": "house"
         },
         {
           "anchor": "Blog",
-          "href": "https://www.all-hands.dev/blog",
+          "href": "https://openhands.dev/blog",
           "icon": "newspaper"
         },
         {
           "anchor": "OpenHands Cloud",
-          "href": "https://app.all-hands.dev",
+          "href": "https://app.openhands.dev",
           "icon": "cloud"
         }
       ]

diff --git a/index.mdx b/index.mdx
@@ -114,7 +114,7 @@ it can modify code, run commands, browse the web, call APIs, and yes-even copy c
 <Columns cols={2}>
   <Card
     title="Slack Server"
-    href="https://all-hands.dev/joinslack"
+    href="https://openhands.dev/joinslack"
   >
     OpenHands has an active community on Slack.
   </Card>

@@ -3931,7 +3931,7 @@
   },
   "servers": [
     {
-      "url": "https://app.all-hands.dev",
+      "url": "https://app.openhands.dev",
       "description": "Production server"
     },
     {

@@ -6,7 +6,7 @@ description: This guide walks you through the process of installing OpenHands Cl
 
 ## Prerequisites
 
-- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a Bitbucket account](/openhands/usage/cloud/openhands-cloud).
+- Signed in to [OpenHands Cloud](https://app.openhands.dev) with [a Bitbucket account](/openhands/usage/cloud/openhands-cloud).
 
 ## Adding Bitbucket Repository Access
 

@@ -5,14 +5,14 @@ description: OpenHands Cloud provides a REST API that allows you to programmatic
 ---
 
 For the available API endpoints, refer to the
-[OpenHands API Reference](https://docs.all-hands.dev/api-reference).
+[OpenHands API Reference](https://docs.openhands.dev/api-reference).
 
 ## Obtaining an API Key
 
 To use the OpenHands Cloud API, you'll need to generate an API key:
 
-1. Log in to your [OpenHands Cloud](https://app.all-hands.dev) account.
-2. Navigate to the [Settings > API Keys](https://app.all-hands.dev/settings/api-keys) page.
+1. Log in to your [OpenHands Cloud](https://app.openhands.dev) account.
+2. Navigate to the [Settings > API Keys](https://app.openhands.dev/settings/api-keys) page.
 3. Click `Create API Key`.
 4. Give your key a descriptive name (Example: "Development" or "Production") and select `Create`.
 5. Copy the generated API key and store it securely. It will only be shown once.
@@ -27,7 +27,7 @@ To start a new conversation with OpenHands to perform a task,
 <Tabs>
   <Tab title="cURL">
     ```bash
-    curl -X POST "https://app.all-hands.dev/api/conversations" \
+    curl -X POST "https://app.openhands.dev/api/conversations" \
       -H "Authorization: Bearer YOUR_API_KEY" \
       -H "Content-Type: application/json" \
       -d '{
@@ -41,7 +41,7 @@ To start a new conversation with OpenHands to perform a task,
     import requests
 
     api_key = "YOUR_API_KEY"
-    url = "https://app.all-hands.dev/api/conversations"
+    url = "https://app.openhands.dev/api/conversations"
 
     headers = {
         "Authorization": f"Bearer {api_key}",
@@ -56,14 +56,14 @@ To start a new conversation with OpenHands to perform a task,
     response = requests.post(url, headers=headers, json=data)
     conversation = response.json()
 
-    print(f"Conversation Link: https://app.all-hands.dev/conversations/{conversation['conversation_id']}")
+    print(f"Conversation Link: https://app.openhands.dev/conversations/{conversation['conversation_id']}")
     print(f"Status: {conversation['status']}")
     ```
     </Tab>
     <Tab title="TypeScript/JavaScript (with fetch)">
         ```typescript
     const apiKey = "YOUR_API_KEY";
-    const url = "https://app.all-hands.dev/api/conversations";
+    const url = "https://app.openhands.dev/api/conversations";
 
     const headers = {
       "Authorization": `Bearer ${apiKey}`,
@@ -85,7 +85,7 @@ To start a new conversation with OpenHands to perform a task,
 
         const conversation = await response.json();
 
-        console.log(`Conversation Link: https://app.all-hands.dev/conversations/${conversation.id}`);
+        console.log(`Conversation Link: https://app.openhands.dev/conversations/${conversation.id}`);
         console.log(`Status: ${conversation.status}`);
 
         return conversation;

@@ -6,7 +6,7 @@ description: This guide walks you through the process of installing OpenHands Cl
 
 ## Prerequisites
 
-- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a GitHub account](/openhands/usage/cloud/openhands-cloud).
+- Signed in to [OpenHands Cloud](https://app.openhands.dev) with [a GitHub account](/openhands/usage/cloud/openhands-cloud).
 
 ## Adding GitHub Repository Access
 

@@ -6,7 +6,7 @@ description: This guide walks you through the process of installing OpenHands Cl
 
 ## Prerequisites
 
-- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a GitLab account](/openhands/usage/cloud/openhands-cloud).
+- Signed in to [OpenHands Cloud](https://app.openhands.dev) with [a GitLab account](/openhands/usage/cloud/openhands-cloud).
 
 ## Adding GitLab Repository Access
 

@@ -6,7 +6,7 @@ description: Getting started with OpenHands Cloud.
 ## Accessing OpenHands Cloud
 
 OpenHands Cloud is the hosted cloud version of OpenHands. To get started with OpenHands Cloud,
-visit [app.all-hands.dev](https://app.all-hands.dev).
+visit [app.all-hands.dev](https://app.openhands.dev).
 
 You'll be prompted to connect with your GitHub, GitLab or Bitbucket account:
 

@@ -47,4 +47,4 @@ The following applies to **both** the Pay-as-you-go and Pro subscription:
 | :---- | :---- |
 | Do I have access to multiple models via the OpenHands LLM provider? | ✅ Yes <br/><br/> [*See models and pricing*](/openhands/usage/llms/openhands-llms#pricing) |
 | Can I generate and refresh OpenHands LLM API keys? | ✅ Yes |
-| How much am I charged for LLM usage when I use the OpenHands LLM provider in other AI coding tools?  | **No markup** \- pay 1x API prices <br/> [*See models and pricing*](/openhands/usage/llms/openhands-llms#pricing) <br/><br/> *Usage is deducted from your OpenHands Cloud credit balance.*  <br/><br/> *The OpenHands LLM provider is available to all OpenHands Cloud users, and LLM usage is billed at-cost (zero markup). Use these models with OpenHands CLI, running OpenHands on your own, or even other AI coding agents\! [Learn more.](https://www.all-hands.dev/blog/access-state-of-the-art-llm-models-at-cost-via-openhands-gui-and-cli)* |
+| How much am I charged for LLM usage when I use the OpenHands LLM provider in other AI coding tools?  | **No markup** \- pay 1x API prices <br/> [*See models and pricing*](/openhands/usage/llms/openhands-llms#pricing) <br/><br/> *Usage is deducted from your OpenHands Cloud credit balance.*  <br/><br/> *The OpenHands LLM provider is available to all OpenHands Cloud users, and LLM usage is billed at-cost (zero markup). Use these models with OpenHands CLI, running OpenHands on your own, or even other AI coding agents\! [Learn more.](https://openhands.dev/blog/access-state-of-the-art-llm-models-at-cost-via-openhands-gui-and-cli)* |
@@ -43,7 +43,7 @@ description: Complete guide for setting up Jira Data Center integration with Ope
    - Go to **Administration** > **System** > **WebHooks**
    - Click **Create a WebHook**
    - **Name**: `OpenHands Cloud Integration`
-   - **URL**: `https://app.all-hands.dev/integration/jira-dc/events`
+   - **URL**: `https://app.openhands.dev/integration/jira-dc/events`
    - Set a suitable webhook secret
    - **Issue related events**: Select the following:
      - Issue updated
@@ -59,7 +59,7 @@ description: Complete guide for setting up Jira Data Center integration with Ope
 ### Step 1: Log in to OpenHands Cloud
 
 1. **Navigate and Authenticate**
-   - Go to [OpenHands Cloud](https://app.all-hands.dev/)
+   - Go to [OpenHands Cloud](https://app.openhands.dev/)
    - Sign in with your Git provider (GitHub, GitLab, or BitBucket)
    - **Important:** Make sure you're signing in with the same Git provider account that contains the repositories you want the OpenHands agent to work on.
 

@@ -47,7 +47,7 @@ description: Complete guide for setting up Jira Cloud integration with OpenHands
 2. **Configure Webhook**
    - **Name**: `OpenHands Cloud Integration`
    - **Status**: Enabled
-   - **URL**: `https://app.all-hands.dev/integration/jira/events`
+   - **URL**: `https://app.openhands.dev/integration/jira/events`
    - **Issue related events**: Select the following:
      - Issue updated
      - Comment created
@@ -62,7 +62,7 @@ description: Complete guide for setting up Jira Cloud integration with OpenHands
 ### Step 1: Log in to OpenHands Cloud
 
 1. **Navigate and Authenticate**
-   - Go to [OpenHands Cloud](https://app.all-hands.dev/)
+   - Go to [OpenHands Cloud](https://app.openhands.dev/)
    - Sign in with your Git provider (GitHub, GitLab, or BitBucket)
    - **Important:** Make sure you're signing in with the same Git provider account that contains the repositories you want the OpenHands agent to work on.
 

@@ -48,7 +48,7 @@ description: Complete guide for setting up Linear integration with OpenHands Clo
 
 2. **Configure Webhook**
    - **Label**: `OpenHands Cloud Integration`
-   - **URL**: `https://app.all-hands.dev/integration/linear/events`
+   - **URL**: `https://app.openhands.dev/integration/linear/events`
    - **Resource types**: Select:
      - `Comment` - For comment events
      - `Issue` - For issue updates (label changes)
@@ -63,7 +63,7 @@ description: Complete guide for setting up Linear integration with OpenHands Clo
 ### Step 1: Log in to OpenHands Cloud
 
 1. **Navigate and Authenticate**
-   - Go to [OpenHands Cloud](https://app.all-hands.dev/)
+   - Go to [OpenHands Cloud](https://app.openhands.dev/)
    - Sign in with your Git provider (GitHub, GitLab, or BitBucket)
    - **Important:** Make sure you're signing in with the same Git provider account that contains the repositories you want the OpenHands agent to work on.
 

@@ -41,7 +41,7 @@ validate critical information independently.
   **Make sure your Slack workspace admin/owner has installed OpenHands Slack App first.**
 
   Every user in the Slack workspace (including admins/owners) must link their OpenHands Cloud account to the OpenHands Slack App. To do this:
-  1. Visit the [Settings > Integrations](https://app.all-hands.dev/settings/integrations) page in OpenHands Cloud.
+  1. Visit the [Settings > Integrations](https://app.openhands.dev/settings/integrations) page in OpenHands Cloud.
   2. Click `Install OpenHands Slack App`.
   3. In the top right corner, select the workspace to install the OpenHands Slack app.
   4. Review permissions and click allow.

@@ -43,8 +43,8 @@ limits and monitor usage.
 
 ### Local / Self-Hosted Models
 
-- [mistralai/devstral-small](https://www.all-hands.dev/blog/devstral-a-new-state-of-the-art-open-model-for-coding-agents) (20 May 2025) -- also available through [OpenRouter](https://openrouter.ai/mistralai/devstral-small:free)
-- [all-hands/openhands-lm-32b-v0.1](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model) (31 March 2025) -- also available through [OpenRouter](https://openrouter.ai/all-hands/openhands-lm-32b-v0.1)
+- [mistralai/devstral-small](https://openhands.dev/blog/devstral-a-new-state-of-the-art-open-model-for-coding-agents) (20 May 2025) -- also available through [OpenRouter](https://openrouter.ai/mistralai/devstral-small:free)
+- [all-hands/openhands-lm-32b-v0.1](https://openhands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model) (31 March 2025) -- also available through [OpenRouter](https://openrouter.ai/all-hands/openhands-lm-32b-v0.1)
 
 ### Known Issues
 

@@ -7,7 +7,7 @@ description: When using a Local LLM, OpenHands may have limited functionality. I
 
 - 2025/05/21: We collaborated with Mistral AI and released [Devstral Small](https://mistral.ai/news/devstral) that achieves [46.8% on SWE-Bench Verified](https://github.com/SWE-bench/experiments/pull/228)!
 - 2025/03/31: We released an open model OpenHands LM 32B v0.1 that achieves 37.1% on SWE-Bench Verified
-([blog](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model), [model](https://huggingface.co/all-hands/openhands-lm-32b-v0.1)).
+([blog](https://openhands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model), [model](https://huggingface.co/all-hands/openhands-lm-32b-v0.1)).
 
 ## Quickstart: Running OpenHands with a Local LLM using LM Studio
 

@@ -8,7 +8,7 @@ icon: rocket
   <Tab title="OpenHands Cloud">
     The easiest way to get started with OpenHands is on OpenHands Cloud, which comes with $20 in free credits for new users.
 
-    To get started with OpenHands Cloud, visit [app.all-hands.dev](https://app.all-hands.dev).
+    To get started with OpenHands Cloud, visit [app.all-hands.dev](https://app.openhands.dev).
 
     For more information see [getting started with OpenHands Cloud.](/openhands/usage/cloud/openhands-cloud)
   </Tab>

@@ -153,7 +153,7 @@ OpenHands requires an API key to access most language models. Here's how to get
 
 <Accordion title="OpenHands (Recommended)">
 
-1. [Log in to OpenHands Cloud](https://app.all-hands.dev).
+1. [Log in to OpenHands Cloud](https://app.openhands.dev).
 2. Go to the Settings page and navigate to the `API Keys` tab.
 3. Copy your `LLM API Key`.
 

@@ -26,7 +26,7 @@ However, a link with a unique ID will still be created that you can share public
 
 ### Who collects and stores the data?
 
-The data is collected and stored by [All Hands AI](https://all-hands.dev), a company founded by OpenHands maintainers to support and improve OpenHands.
+The data is collected and stored by [All Hands AI](https://openhands.dev), a company founded by OpenHands maintainers to support and improve OpenHands.
 
 ### How will public data be released?
 

@@ -49,15 +49,15 @@ from openhands.sdk import LLM
 llm = LLM(
     model="anthropic/claude-sonnet-4.1",
     api_key=SecretStr("sk-ant-123"),
-    service_id="primary",
+    usage_id="primary",
     temperature=0.1,
     timeout=120,
 )
 ```
 
 Key concepts:
 
-- **`service_id`** identifies an LLM configuration when storing it in a registry
+- **`usage_id`** identifies an LLM configuration when storing it in a registry
   or persisting it between runs.
 - **Retry settings** (`num_retries`, `retry_min_wait`, etc.) apply uniformly to
   all providers through LiteLLM.

@@ -22,7 +22,7 @@ The SDK requires an LLM API key from any [LiteLLM-supported provider](https://do
 
 <AccordionGroup>
   <Accordion title="Option 1: OpenHands Cloud (Recommended)" icon="cloud">
-    Sign up for [OpenHands Cloud](https://app.all-hands.dev) and get an API key from the [API keys page](https://app.all-hands.dev/settings/api-keys). This gives you access to recommended models with no markup.
+    Sign up for [OpenHands Cloud](https://app.openhands.dev) and get an API key from the [API keys page](https://app.openhands.dev/settings/api-keys). This gives you access to recommended models with no markup.
 
     [Learn more →](/openhands/usage/llms/openhands-llms)
   </Accordion>
@@ -155,9 +155,9 @@ ls examples/01_standalone_sdk/
 
 ### Explore Documentation
 
-- **[SDK Architecture](/sdk/architecture/overview)** - Deep dive into components
-- **[Tool Documentation](/sdk/architecture/tools/overview)** - Available tools
-- **[Workspace Options](/sdk/architecture/workspace/overview)** - Execution environments
+- **[SDK Architecture](/sdk/arch/sdk/overview)** - Deep dive into components
+- **[Tool Documentation](/sdk/arch/tools/overview)** - Available tools
+- **[Workspace Options](/sdk/arch/workspace/overview)** - Execution environments
 
 ### Build Custom Solutions
 
@@ -167,6 +167,6 @@ ls examples/01_standalone_sdk/
 
 ### Get Help
 
-- **[Slack Community](https://all-hands.dev/joinslack)** - Ask questions and share projects
+- **[Slack Community](https://openhands.dev/joinslack)** - Ask questions and share projects
 - **[GitHub Issues](https://github.com/All-Hands-AI/agent-sdk/issues)** - Report bugs or request features
 - **[Example Directory](https://github.com/All-Hands-AI/agent-sdk/tree/main/examples)** - Browse working code samples
@@ -308,5 +308,5 @@ Create custom tools when you need to:
 
 ## Next Steps
 
-- **[Tool System Architecture](/sdk/architecture/sdk/tool)** - Deep dive into the tool system
+- **[Tool System Architecture](/sdk/arch/sdk/tool)** - Deep dive into the tool system
 - **[Model Context Protocol (MCP) Integration](/sdk/guides/mcp)** - Use Model Context Protocol servers
@@ -89,7 +89,7 @@ conversation = Conversation(
 
 logger.info("Starting conversation with MCP integration...")
 conversation.send_message(
-    "Read https://github.com/All-Hands-AI/OpenHands and write 3 facts "
+    "Read https://github.com/OpenHands/OpenHands and write 3 facts "
     "about the project into FACTS.txt."
 )
 conversation.run()
@@ -242,6 +242,6 @@ mcp_config = {
 
 ## Next Steps
 
-- **[MCP Architecture](/sdk/architecture/sdk/mcp)** - Technical details and internals
+- **[MCP Architecture](/sdk/arch/sdk/mcp)** - Technical details and internals
 - **[Custom Tools](/sdk/guides/custom-tools)** - Creating native SDK tools
 - **[Security Analyzer](/sdk/guides/security-analyzer)** - Securing tool usage
@@ -61,7 +61,7 @@ Other SDKs (e.g. [Claude Code](https://github.com/anthropics/claude-agent-sdk-py
 <Columns cols={1}>
   <Card
     title="Getting Started Guide"
-    href="/sdk/guides/getting-started"
+    href="/sdk/getting-started"
   >
     Install the SDK, run your first agent, and explore the guides.
   </Card>
@@ -72,7 +72,7 @@ Other SDKs (e.g. [Claude Code](https://github.com/anthropics/claude-agent-sdk-py
 <Columns cols={2}>
   <Card
     title="Core Concepts"
-    href="/sdk/architecture/overview"
+    href="/sdk/arch/overview"
   >
     Understand the SDK's architecture: agents, tools, workspaces, and more.
   </Card>
@@ -112,7 +112,7 @@ Other SDKs (e.g. [Claude Code](https://github.com/anthropics/claude-agent-sdk-py
 <Columns cols={2}>
   <Card
     title="Join Slack"
-    href="https://all-hands.dev/joinslack"
+    href="https://openhands.dev/joinslack"
   >
     Connect with the OpenHands community on Slack.
   </Card>