Improve SDK, AgentOS, and Templates developer journeys

agent-os/connect-your-os.mdx

@@ -1,12 +1,14 @@
 ---
 title: "Connect Your AgentOS"
-description: "Connect your AgentOS to the control plane for monitoring and management."
+description: "Connect an AgentOS runtime to the Control Plane to manage and monitor it from one web interface."
 ---
 
-## Connect Your AgentOS
+Connect local, staging, and production AgentOS runtimes to the Control Plane. Test registered components, inspect sessions and traces, and manage runtime data from the same interface.
+
+The Control Plane connects directly from your browser to the runtime endpoint.
 
 1. Open [os.agno.com](https://os.agno.com) and sign in
-2. Click **"Add new OS"**
+2. Click **Add new OS**
 
 <Frame>
   <video
@@ -21,7 +23,7 @@ description: "Connect your AgentOS to the control plane for monitoring and manag
   </video>
 </Frame>
 
-## Configure Connection
+## Configure the connection
 
 | Field | Description |
 |-------|-------------|
@@ -30,12 +32,12 @@ description: "Connect your AgentOS to the control plane for monitoring and manag
 | **OS Name** | A descriptive name, e.g. "Development OS" |
 | **Tags** | Optional. Organize with labels like `dev`, `stg`, `prd` |
 
-Click **"CONNECT"**. If successful, your OS appears in the dashboard.
+Click **CONNECT**. If successful, your runtime appears in the dashboard.
 
-## Verify Connection
+## Verify the connection
 
 | Indicator | Expected |
 |-----------|----------|
-| Status | "Running" |
-| Features | Chat, Knowledge, Memory, Sessions accessible |
-| Agents | Configured agents appear in the chat interface |
+| Status | The runtime shows as running |
+| Components | Registered agents, teams, and workflows appear |
+| Runtime data | Sessions, memory, knowledge, and traces appear when configured |

agent-os/control-plane.mdx

@@ -1,9 +1,9 @@
 ---
 title: "AgentOS Control Plane"
-description: "A web interface for testing, monitoring, and managing your multi-agent system."
+description: "Manage and monitor AgentOS runtimes from one web interface."
 ---
 
-The control plane at [os.agno.com](https://os.agno.com) is where you chat with agents, view traces, manage knowledge, track sessions, and monitor performance.
+The AgentOS Control Plane at [os.agno.com](https://os.agno.com) lets you manage and monitor connected AgentOS runtimes. Chat with agents, inspect traces and sessions, manage knowledge and memory, review approvals, and operate schedules from one web interface.
 
 <Frame>
   <img
@@ -15,7 +15,7 @@ The control plane at [os.agno.com](https://os.agno.com) is where you chat with a
 
 <Tip>
 
-It connects directly from your browser to your AgentOS runtime. No data is sent to Agno.
+The Control Plane connects directly from your browser to your AgentOS runtime.
 
 </Tip>