@standardagents/cli 0.8.1

package/README.md

@@ -0,0 +1,81 @@
+# @standardagents/cli
+
+CLI tool for Standard Agents initialization.
+
+## Installation
+
+```bash
+pnpm add -D @standardagents/cli
+```
+
+## Usage
+
+### Initialize AgentBuilder Configuration
+
+```bash
+pnpm exec agents init
+```
+
+This command will:
+- Detect your `wrangler.jsonc` or `wrangler.json` file
+- Add the required Durable Object bindings (`AGENT_BUILDER_THREAD`, `AGENT_BUILDER`)
+- Configure Durable Object migrations
+
+If no wrangler config is found, it will provide an example configuration.
+
+#### Options
+
+- `--force` - Overwrite existing Standard Agents configuration
+
+### Scaffold Project Structure
+
+```bash
+pnpm exec agents scaffold
+```
+
+Creates the `agents/` directory structure with documentation files.
+
+## Manual Configuration
+
+If you prefer to configure manually, add the following to your `wrangler.jsonc`:
+
+```jsonc
+{
+  "durable_objects": {
+    "bindings": [
+      {
+        "name": "AGENT_BUILDER_THREAD",
+        "class_name": "DurableThread"
+      },
+      {
+        "name": "AGENT_BUILDER",
+        "class_name": "DurableAgentBuilder"
+      }
+    ]
+  },
+
+  "migrations": [
+    {
+      "tag": "v1",
+      "new_sqlite_classes": ["DurableThread", "DurableAgentBuilder"]
+    }
+  ]
+}
+```
+
+## TypeScript Types
+
+To get proper TypeScript types for the bindings, regenerate your worker types:
+
+```bash
+pnpm cf-typegen
+```
+
+This will update your `worker-configuration.d.ts` file with:
+
+```typescript
+interface Env {
+  AGENT_BUILDER_THREAD: DurableObjectNamespace<DurableThread>;
+  AGENT_BUILDER: DurableObjectNamespace<DurableAgentBuilder>;
+}
+```