Move client creation to functions

docs/auth/byok.md

@@ -23,13 +23,13 @@ Azure AI Foundry (formerly Azure OpenAI) is a common BYOK deployment target for
 ```python
 import asyncio
 import os
-from copilot import CopilotClient
+import copilot
 
 FOUNDRY_MODEL_URL = "https://your-resource.openai.azure.com/openai/v1/"
 # Set FOUNDRY_API_KEY environment variable
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({

docs/auth/index.md

@@ -38,10 +38,10 @@ const client = new CopilotClient();
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
 # Default: uses logged-in user credentials
-client = CopilotClient()
+client = copilot.cli_client()
 await client.start()
 ```
 
@@ -106,12 +106,11 @@ const client = new CopilotClient({
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
-client = CopilotClient({
-    "github_token": user_access_token,  # Token from OAuth flow
-    "use_logged_in_user": False,        # Don't use stored CLI credentials
-})
+client = copilot.cli_client(
+    github_token=user_access_token,  # Token from OAuth flow
+)
 await client.start()
 ```
 
@@ -194,10 +193,10 @@ const client = new CopilotClient();
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
 # Token is read from environment variable automatically
-client = CopilotClient()
+client = copilot.cli_client()
 await client.start()
 ```
 
@@ -256,9 +255,7 @@ const client = new CopilotClient({
 
 <!-- docs-validate: skip -->
 ```python
-client = CopilotClient({
-    "use_logged_in_user": False,  # Only use explicit tokens
-})
+client = copilot.cli_client(use_logged_in_user=False)  # Only use explicit tokens
 ```
 
 </details>

docs/debugging.md

@@ -34,9 +34,9 @@ const client = new CopilotClient({
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
-client = CopilotClient({"log_level": "debug"})
+client = copilot.cli_client(log_level="debug")
 ```
 
 </details>
@@ -164,7 +164,7 @@ var client = new CopilotClient(new CopilotClientOptions
    <summary><strong>Python</strong></summary>
 
    ```python
-   client = CopilotClient({"cli_path": "/usr/local/bin/copilot"})
+   client = copilot.cli_client("/usr/local/bin/copilot")
    ```
    </details>
 
@@ -217,7 +217,7 @@ var client = new CopilotClient(new CopilotClientOptions
 
    ```python
    import os
-   client = CopilotClient({"github_token": os.environ.get("GITHUB_TOKEN")})
+   client = copilot.cli_client(github_token=os.environ.get("GITHUB_TOKEN"))
    ```
    </details>
 

docs/getting-started.md

@@ -129,10 +129,10 @@ Create `main.py`:
 
 ```python
 import asyncio
-from copilot import CopilotClient
+import copilot
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({"model": "gpt-4.1"})
@@ -274,11 +274,11 @@ Update `main.py`:
 ```python
 import asyncio
 import sys
-from copilot import CopilotClient
+import copilot
 from copilot.generated.session_events import SessionEventType
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({
@@ -565,7 +565,7 @@ Update `main.py`:
 import asyncio
 import random
 import sys
-from copilot import CopilotClient
+import copilot
 from copilot.tools import define_tool
 from copilot.generated.session_events import SessionEventType
 from pydantic import BaseModel, Field
@@ -585,7 +585,7 @@ async def get_weather(params: GetWeatherParams) -> dict:
     return {"city": city, "temperature": f"{temp}°F", "condition": condition}
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({
@@ -837,7 +837,7 @@ Create `weather_assistant.py`:
 import asyncio
 import random
 import sys
-from copilot import CopilotClient
+import copilot
 from copilot.tools import define_tool
 from copilot.generated.session_events import SessionEventType
 from pydantic import BaseModel, Field
@@ -854,7 +854,7 @@ async def get_weather(params: GetWeatherParams) -> dict:
     return {"city": city, "temperature": f"{temp}°F", "condition": condition}
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({
@@ -1210,11 +1210,10 @@ const session = await client.createSession({ onPermissionRequest: approveAll });
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient, PermissionHandler
+import copilot
+from copilot import PermissionHandler
 
-client = CopilotClient({
-    "cli_url": "localhost:4321"
-})
+client = copilot.network_client("localhost:4321")
 await client.start()
 
 # Use the client normally

docs/guides/session-persistence.md

@@ -46,9 +46,9 @@ await session.sendAndWait({ prompt: "Analyze my codebase" });
 ### Python
 
 ```python
-from copilot import CopilotClient
+import copilot
 
-client = CopilotClient()
+client = copilot.cli_client()
 await client.start()
 
 # Create a session with a meaningful ID

docs/guides/setup/azure-managed-identity.md

@@ -42,7 +42,8 @@ import asyncio
 import os
 
 from azure.identity import DefaultAzureCredential
-from copilot import CopilotClient, ProviderConfig, SessionConfig
+import copilot
+from copilot import ProviderConfig, SessionConfig
 
 COGNITIVE_SERVICES_SCOPE = "https://cognitiveservices.azure.com/.default"
 
@@ -54,7 +55,7 @@ async def main():
 
     foundry_url = os.environ["AZURE_AI_FOUNDRY_RESOURCE_URL"]
 
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session(
@@ -84,7 +85,8 @@ Bearer tokens expire (typically after ~1 hour). For servers or long-running agen
 
 ```python
 from azure.identity import DefaultAzureCredential
-from copilot import CopilotClient, ProviderConfig, SessionConfig
+import copilot
+from copilot import ProviderConfig, SessionConfig
 
 COGNITIVE_SERVICES_SCOPE = "https://cognitiveservices.azure.com/.default"
 
@@ -96,7 +98,7 @@ class ManagedIdentityCopilotAgent:
         self.foundry_url = foundry_url.rstrip("/")
         self.model = model
         self.credential = DefaultAzureCredential()
-        self.client = CopilotClient()
+        self.client = copilot.cli_client()
 
     def _get_session_config(self) -> SessionConfig:
         """Build a SessionConfig with a fresh bearer token."""

docs/guides/setup/backend-services.md

@@ -111,11 +111,9 @@ res.json({ content: response?.data.content });
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
-client = CopilotClient({
-    "cli_url": "localhost:4321",
-})
+client = copilot.network_client("localhost:4321")
 await client.start()
 
 session = await client.create_session({

docs/guides/setup/bundled-cli.md

@@ -85,12 +85,10 @@ await client.stop();
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 from pathlib import Path
 
-client = CopilotClient({
-    "cli_path": str(Path(__file__).parent / "vendor" / "copilot"),
-})
+client = copilot.cli_client(str(Path(__file__).parent / "vendor" / "copilot"))
 await client.start()
 
 session = await client.create_session({"model": "gpt-4.1"})

docs/guides/setup/byok.md

@@ -93,9 +93,9 @@ await client.stop();
 
 ```python
 import os
-from copilot import CopilotClient
+import copilot
 
-client = CopilotClient()
+client = copilot.cli_client()
 await client.start()
 
 session = await client.create_session({

docs/guides/setup/github-oauth.md

@@ -145,13 +145,13 @@ const response = await session.sendAndWait({ prompt: "Hello!" });
 <summary><strong>Python</strong></summary>
 
 ```python
+import copilot
 from copilot import CopilotClient
 
 def create_client_for_user(user_token: str) -> CopilotClient:
-    return CopilotClient({
-        "github_token": user_token,
-        "use_logged_in_user": False,
-    })
+    return copilot.cli_client(
+        github_token=user_token,
+    )
 
 # Usage
 client = create_client_for_user("gho_user_access_token")

docs/guides/setup/local-cli.md

@@ -51,9 +51,9 @@ await client.stop();
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
-client = CopilotClient()
+client = copilot.cli_client()
 await client.start()
 
 session = await client.create_session({"model": "gpt-4.1"})

docs/guides/skills.md

@@ -42,10 +42,10 @@ await session.sendAndWait({ prompt: "Review this code for security issues" });
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({

docs/hooks/overview.md

@@ -53,10 +53,10 @@ const session = await client.createSession({
 <summary><strong>Python</strong></summary>
 
 ```python
-from copilot import CopilotClient
+import copilot
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     async def on_pre_tool_use(input_data, invocation):

docs/mcp/overview.md

@@ -59,10 +59,10 @@ const session = await client.createSession({
 
 ```python
 import asyncio
-from copilot import CopilotClient
+import copilot
 
 async def main():
-    client = CopilotClient()
+    client = copilot.cli_client()
     await client.start()
 
     session = await client.create_session({