create-computeragent 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComputerAgent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# create-computeragent
+
+Scaffold a runnable [ComputerAgent](https://github.com/open-gitagent/ComputerAgent) project in 60 seconds.
+
+```bash
+npx create-computeragent my-agent
+cd my-agent
+npm install
+ANTHROPIC_API_KEY=sk-ant-... npm start
+```
+
+That's it. The output is a single TS file plus a `package.json` — no build tools, no boilerplate, just `runTask({...})` against a local substrate.
+
+## What you get
+
+```
+my-agent/
+├── package.json     # depends on @computeragent/sdk + @computeragent/runtime-local
+├── index.ts         # one inline GAP agent + runTask call
+├── README.md
+└── .gitignore
+```
+
+`index.ts` is fully runnable. It defines an inline GAP agent (model + system prompt), boots a local subprocess, runs one turn, and prints the agent's reply.
+
+## Next steps
+
+- Swap the substrate: `npm install @computeragent/runtime-e2b` then replace `new LocalSubstrate()` with `new E2BSubstrate({apiKey})`.
+- Add cross-process memory: pass `sessionStore: { kind: "file", options: { root: "./sessions" } }` and re-run with the same `sessionId`.
+- Build a real GAP repo: see https://github.com/open-gitagent/gitagent-protocol.
+
+## Options
+
+```
+npx create-computeragent <project-name> [--force]
+```
+
+`--force` lets you scaffold into a non-empty directory.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+/**
+ * `npx create-computeragent <project-name>`
+ *
+ * Scaffolds a runnable ComputerAgent project in one command. The output is a
+ * single TS file + a package.json that depends on the published packages, so
+ * the user can:
+ *
+ *   npx create-computeragent my-agent
+ *   cd my-agent
+ *   npm install
+ *   ANTHROPIC_API_KEY=sk-... npm start
+ *
+ * No prompts, no questions — opinionated defaults, runnable in under a minute.
+ */
+import { mkdir, writeFile, readdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve, basename, join } from "node:path";
+const args = process.argv.slice(2);
+const positional = args.filter((a) => !a.startsWith("--"));
+const flags = new Set(args.filter((a) => a.startsWith("--")));
+if (flags.has("--help") || flags.has("-h")) {
+    printHelp();
+    process.exit(0);
+}
+const projectName = positional[0] ?? "my-computeragent";
+const targetDir = resolve(process.cwd(), projectName);
+if (existsSync(targetDir)) {
+    const dirContents = await readdir(targetDir).catch(() => []);
+    if (dirContents.length > 0 && !flags.has("--force")) {
+        console.error(`Error: '${projectName}' already exists and is not empty.`);
+        console.error(`Use --force to overwrite, or pick a different name.`);
+        process.exit(1);
+    }
+}
+await mkdir(targetDir, { recursive: true });
+await writeFile(join(targetDir, "package.json"), JSON.stringify({
+    name: basename(projectName),
+    version: "0.1.0",
+    private: true,
+    type: "module",
+    scripts: {
+        start: "node --experimental-strip-types index.ts",
+    },
+    dependencies: {
+        computeragent: "^0.1.0",
+    },
+    engines: { node: ">=22.6.0" },
+}, null, 2));
+await writeFile(join(targetDir, "index.ts"), `import { runTask, LocalSubstrate } from "computeragent";
+
+const apiKey = process.env.ANTHROPIC_API_KEY;
+if (!apiKey) {
+  console.error("Set ANTHROPIC_API_KEY first.");
+  console.error("  export ANTHROPIC_API_KEY=sk-ant-...");
+  process.exit(1);
+}
+
+const result = await runTask({
+  source: {
+    type: "inline",
+    manifest: { name: "${basename(projectName)}", version: "0.1.0" },
+    files: {
+      "agent.yaml": [
+        'spec_version: "0.1.0"',
+        "name: ${basename(projectName)}",
+        "version: 0.1.0",
+        "model:",
+        "  preferred: claude-haiku-4-5-20251001",
+        "runtime:",
+        "  max_turns: 4",
+      ].join("\\n"),
+      "SOUL.md": [
+        "# Soul",
+        "",
+        "You are a friendly assistant. Respond concisely.",
+        "When asked to write a file, use the Write tool.",
+      ].join("\\n"),
+    },
+  },
+  harness: "claude-agent-sdk",
+  envs: { ANTHROPIC_API_KEY: apiKey },
+  runtime: new LocalSubstrate(),
+  options: { permissionMode: "bypassPermissions", settingSources: ["project"] },
+  message: "Say hi and tell me one thing you can do.",
+});
+
+for (const m of result.messages) {
+  const msg = m as { type?: string; result?: string; message?: { content?: unknown[] } };
+  if (msg.type === "result" && msg.result) {
+    console.log("\\nA:", msg.result);
+  }
+}
+console.log("\\nSession:", result.sessionId, "(reason:", result.ended.reason + ")");
+`);
+await writeFile(join(targetDir, ".gitignore"), ["node_modules", "dist", ".env", ".env.local", "*.log", ""].join("\n"));
+await writeFile(join(targetDir, "README.md"), `# ${basename(projectName)}
+
+A starter [ComputerAgent](https://github.com/open-gitagent/ComputerAgent) project.
+
+## Run
+
+\`\`\`bash
+npm install
+ANTHROPIC_API_KEY=sk-ant-... npm start
+\`\`\`
+
+## What this is
+
+A minimal agent defined inline in \`index.ts\` and run in a local subprocess via \`runTask\`.
+The substrate boots, the agent runs one turn, the substrate is torn down — all in one call.
+
+## Swap the substrate
+
+Replace \`new LocalSubstrate()\` with \`new E2BSubstrate({apiKey})\` for a cloud sandbox,
+or \`new VZVMSubstrate({...})\` for an Apple Silicon VM. Same code, different runtime.
+
+\`\`\`bash
+npm install @computeragent/runtime-e2b
+\`\`\`
+
+## Add memory
+
+Pass \`sessionStore: { kind: "file", options: { root: "./sessions" } }\` and the same
+\`sessionId\` on a follow-up call to resume the conversation across processes.
+
+See https://github.com/open-gitagent/ComputerAgent for the full guide.
+`);
+console.log(``);
+console.log(`✓ Created ${projectName}/`);
+console.log(``);
+console.log(`Next:`);
+console.log(`  cd ${projectName}`);
+console.log(`  npm install`);
+console.log(`  export ANTHROPIC_API_KEY=sk-ant-...`);
+console.log(`  npm start`);
+console.log(``);
+console.log(`Docs: https://github.com/open-gitagent/ComputerAgent`);
+console.log(``);
+function printHelp() {
+    console.log(`create-computeragent — scaffold a ComputerAgent project`);
+    console.log(``);
+    console.log(`Usage:`);
+    console.log(`  npx create-computeragent <project-name> [--force]`);
+    console.log(``);
+    console.log(`Options:`);
+    console.log(`  --force    Overwrite a non-empty target directory`);
+    console.log(`  --help     Show this message`);
+    console.log(``);
+    console.log(`Example:`);
+    console.log(`  npx create-computeragent my-agent`);
+    console.log(`  cd my-agent && npm install && ANTHROPIC_API_KEY=sk-... npm start`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-computeragent",
+  "version": "0.1.1",
+  "description": "Scaffold a runnable ComputerAgent project in 60 seconds. `npx create-computeragent my-agent`",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-computeragent": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "template",
+    "README.md"
+  ],
+  "keywords": [
+    "ai-agents",
+    "agent-framework",
+    "anthropic",
+    "claude",
+    "agent-protocol",
+    "scaffolding",
+    "create-app"
+  ],
+  "homepage": "https://github.com/open-gitagent/ComputerAgent",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/open-gitagent/ComputerAgent.git",
+    "directory": "packages/create-computeragent"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli.js 2>/dev/null || true",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo"
+  }
+}