3 files changed, 29 insertions, 0 deletions
diff --git a/packages/sdk/python/examples/basic_usage.py b/packages/sdk/python/examples/basic_usage.py
new file mode 100644
index 000000000..0d8349959
--- /dev/null
+++ b/packages/sdk/python/examples/basic_usage.py
@@ -0,0 +1,19 @@
+# Basic usage example (placeholder)
+# After generating the client, this should reflect actual client entrypoints.
+
+try:
+    from opencode_ai import client  # type: ignore
+except Exception:  # pragma: no cover
+    client = None
+
+
+def main() -> None:
+    if client is None:
+        print("Client not generated yet. Run the generator first:")
+        print("    uv run python packages/sdk/python/scripts/generate.py")
+        return
+    print("Replace this with real example code once the client is generated.")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/packages/sdk/python/examples/file_status.py b/packages/sdk/python/examples/file_status.py
new file mode 100644
index 000000000..e86cfa3f6
--- /dev/null
+++ b/packages/sdk/python/examples/file_status.py
@@ -0,0 +1,6 @@
+from opencode_ai import OpenCodeClient
+
+client = OpenCodeClient()
+files = client.file_status() or []
+for f in files:
+    print(f.path, f.type)
diff --git a/packages/sdk/python/examples/session_list.py b/packages/sdk/python/examples/session_list.py
new file mode 100644
index 000000000..6d4939f12
--- /dev/null
+++ b/packages/sdk/python/examples/session_list.py
@@ -0,0 +1,4 @@
+from opencode_ai import OpenCodeClient
+
+client = OpenCodeClient()
+print([s.id for s in client.list_sessions() or []])