cppx
diff --git a/‎packages/docs/docs.json‎
Lines changed: 4 additions & 37 deletions b/‎packages/docs/docs.json‎
Lines changed: 4 additions & 37 deletions
diff --git a/‎packages/docs/openapi.json‎
Lines changed: 1 addition & 0 deletions b/‎packages/docs/openapi.json‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎packages/opencode/src/cli/cmd/generate.ts‎
Lines changed: 20 additions & 0 deletions b/‎packages/opencode/src/cli/cmd/generate.ts‎
Lines changed: 20 additions & 0 deletions
diff --git a/‎packages/opencode/src/server/project.ts‎
Lines changed: 5 additions & 3 deletions b/‎packages/opencode/src/server/project.ts‎
Lines changed: 5 additions & 3 deletions
@@ -8,53 +8,20 @@
     "dark": "#15803D"
   },
   "favicon": "/favicon.svg",
-  "servers": [
-    {
-      "url": "https://opencode.ai/openapi.json"
-    }
-  ],
   "navigation": {
     "tabs": [
       {
-        "tab": "Guides",
+        "tab": "SDK",
         "groups": [
           {
             "group": "Getting started",
-            "pages": ["index", "quickstart", "development"]
-          },
-          {
-            "group": "Customization",
-            "pages": ["essentials/settings", "essentials/navigation"]
-          },
-          {
-            "group": "Writing content",
-            "pages": ["essentials/markdown", "essentials/code", "essentials/images", "essentials/reusable-snippets"]
-          },
-          {
-            "group": "AI tools",
-            "pages": ["ai-tools/cursor", "ai-tools/claude-code", "ai-tools/windsurf"]
+            "pages": ["index", "quickstart", "development"],
+            "openapi": "./openapi.json"
           }
         ]
-      },
-      {
-        "tab": "API Reference",
-        "openapi": "https://opencode.ai/openapi.json"
       }
     ],
-    "global": {
-      "anchors": [
-        {
-          "anchor": "Documentation",
-          "href": "https://mintlify.com/docs",
-          "icon": "book-open-cover"
-        },
-        {
-          "anchor": "Blog",
-          "href": "https://mintlify.com/blog",
-          "icon": "newspaper"
-        }
-      ]
-    }
+    "global": {}
   },
   "logo": {
     "light": "/logo/light.svg",
 
@@ -0,0 +1 @@
+../sdk/openapi.json
@@ -5,6 +5,26 @@ export const GenerateCommand = {
   command: "generate",
   handler: async () => {
     const specs = await Server.openapi()
+    for (const item of Object.values(specs.paths)) {
+      for (const method of ["get", "post", "put", "delete", "patch"] as const) {
+        const operation = item[method]
+        if (!operation?.operationId) continue
+        // @ts-expect-error
+        operation["x-codeSamples"] = [
+          {
+            lang: "js",
+            source: [
+              `import { createOpencodeClient } from "@opencode-ai/sdk`,
+              ``,
+              `const client = createOpencodeClient()`,
+              `await client.${operation.operationId}({`,
+              `  ...`,
+              `})`,
+            ].join("\n"),
+          },
+        ]
+      }
+    }
     const json = JSON.stringify(specs, null, 2)
 
     // Wait for stdout to finish writing before process.exit() is called
 
@@ -8,7 +8,8 @@ export const ProjectRoute = new Hono()
   .get(
     "/",
     describeRoute({
-      description: "List all projects",
+      summary: "List all projects",
+      description: "Get a list of projects that have been opened with OpenCode.",
       operationId: "project.list",
       responses: {
         200: {
@@ -29,11 +30,12 @@ export const ProjectRoute = new Hono()
   .get(
     "/current",
     describeRoute({
-      description: "Get the current project",
+      summary: "Get current project",
+      description: "Retrieve the currently active project that OpenCode is working with.",
       operationId: "project.current",
       responses: {
         200: {
-          description: "Current project",
+          description: "Current project information",
           content: {
             "application/json": {
               schema: resolver(Project.Info),