1 files changed, 22 insertions, 0 deletions
diff --git a/packages/sdk/python/docs/quickstart.md b/packages/sdk/python/docs/quickstart.md
new file mode 100644
index 000000000..97465c203
--- /dev/null
+++ b/packages/sdk/python/docs/quickstart.md
@@ -0,0 +1,22 @@
+# Quickstart
+
+Create a client and make your first calls.
+
+```python
+from opencode_ai import OpenCodeClient
+
+client = OpenCodeClient(base_url="http://localhost:4096")
+
+# List projects
+for p in client.list_projects() or []:
+    print(p.id, p.directory)
+
+# Get path info
+path = client.get_path()
+print(path.directory)
+
+# Stream events (sync)
+for event in client.subscribe_events():
+    print(event)
+    break
+```