create-aixyz-app 0.27.0 → 0.28.0

package/dist/index.js

@@ -3215,11 +3215,31 @@ var {
 
 // src/index.ts
 import { execSync } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync as writeFileSync3 } from "node:fs";
+
+// src/generate-agent-files.ts
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+function generateAgentFiles(root) {
+  const agentsMdContent = `<!-- BEGIN:aixyz-agent-rules -->
+
+# aixyz: ALWAYS read docs before coding
+
+Before any aixyz work, find and read the relevant doc in \`node_modules/aixyz/docs/\`.
+And you can read \`node_modules/aixyz/examples/\` for examples that you can reference.
+Your training data is outdated — the docs are the source of truth.
+
+<!-- END:aixyz-agent-rules -->
+`;
+  const claudeMdContent = `@AGENTS.md
+`;
+  writeFileSync(join(root, "AGENTS.md"), agentsMdContent);
+  writeFileSync(join(root, "CLAUDE.md"), claudeMdContent);
+}
 
 // src/generate-icon.ts
 import { randomInt } from "node:crypto";
-import { writeFileSync } from "node:fs";
+import { writeFileSync as writeFileSync2 } from "node:fs";
 function randomHsl() {
   return {
     h: randomInt(360),
@@ -3240,15 +3260,15 @@ function buildSvg(h, s, l, fg) {
 function generateIcon(outputPath) {
   const { h, s, l } = randomHsl();
   const fg = contrastColor(l);
-  writeFileSync(outputPath, buildSvg(h, s, l, fg));
+  writeFileSync2(outputPath, buildSvg(h, s, l, fg));
 }
 
 // src/index.ts
-import { join, resolve } from "node:path";
+import { join as join2, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 var DEFAULT_PAY_TO = "0x0799872E07EA7a63c79357694504FE66EDfE4a0A";
 var program2 = new Command;
-program2.name("create-aixyz-app").description("Scaffold a new aixyz agent project").argument("[name]", "Agent name", "my-agent").option("-y, --yes", "Use defaults for all prompts (non-interactive)").option("--erc-8004", "Include ERC-8004 Agent Identity support").option("--openai-api-key <key>", "Set OpenAI API Key in .env.local").option("--pay-to <address>", "x402 payTo Ethereum address", DEFAULT_PAY_TO).option("--no-install", "Skip dependency installation").addHelpText("after", `
+program2.name("create-aixyz-app").description("Scaffold a new aixyz agent project").argument("[name]", "Agent name", "my-agent").option("-y, --yes", "Use defaults for all prompts (non-interactive)").option("--erc-8004", "Include ERC-8004 Agent Identity support").option("--openai-api-key <key>", "Set OpenAI API Key in .env.local").option("--pay-to <address>", "x402 payTo Ethereum address", DEFAULT_PAY_TO).option("--no-install", "Skip dependency installation").option("--no-agents-md", "Skip generating AGENTS.md and CLAUDE.md").addHelpText("after", `
 Non-interactive example (CI/AI-friendly):
   $ bunx create-aixyz-app my-agent --yes
   $ bunx create-aixyz-app my-agent --erc-8004 --openai-api-key sk-... --pay-to 0x...
@@ -3367,41 +3387,44 @@ if (payTo === DEFAULT_PAY_TO && !isNonInteractive) {
   payTo = payToInput || DEFAULT_PAY_TO;
 }
 var __filename2 = fileURLToPath(import.meta.url);
-var templateDir = join(__filename2, "..", "..", "templates", "default");
+var templateDir = join2(__filename2, "..", "..", "templates", "default");
 if (!existsSync(templateDir)) {
   Ne("Template directory not found. This is a bug in create-aixyz-app.");
   process.exit(1);
 }
 mkdirSync(targetDir, { recursive: true });
 cpSync(templateDir, targetDir, { recursive: true });
-generateIcon(join(targetDir, "app", "icon.svg"));
+generateIcon(join2(targetDir, "app", "icon.svg"));
+if (opts.agentsMd) {
+  generateAgentFiles(targetDir);
+}
 if (!includeErc8004) {
-  const erc8004Path = join(targetDir, "app", "erc-8004.ts");
+  const erc8004Path = join2(targetDir, "app", "erc-8004.ts");
   if (existsSync(erc8004Path)) {
     rmSync(erc8004Path);
   }
 }
-var gitignoreSrc = join(targetDir, "gitignore");
+var gitignoreSrc = join2(targetDir, "gitignore");
 if (existsSync(gitignoreSrc)) {
-  renameSync(gitignoreSrc, join(targetDir, ".gitignore"));
+  renameSync(gitignoreSrc, join2(targetDir, ".gitignore"));
 }
-var envLocalSrc = join(targetDir, "env.local");
+var envLocalSrc = join2(targetDir, "env.local");
 if (existsSync(envLocalSrc)) {
   rmSync(envLocalSrc);
 }
 var envContent = openaiApiKey ? `OPENAI_API_KEY=${openaiApiKey}
 ` : `OPENAI_API_KEY=
 `;
-writeFileSync2(join(targetDir, ".env.local"), envContent);
+writeFileSync3(join2(targetDir, ".env.local"), envContent);
 var filesToReplace = ["package.json", "aixyz.config.ts", "README.md"];
 for (const file of filesToReplace) {
-  const filePath = join(targetDir, file);
+  const filePath = join2(targetDir, file);
   if (existsSync(filePath)) {
     let content = readFileSync(filePath, "utf-8");
     content = content.replaceAll("{{PKG_NAME}}", pkgName);
     content = content.replaceAll("{{AGENT_NAME}}", agentName);
     content = content.replaceAll("{{PAY_TO}}", payTo);
-    writeFileSync2(filePath, content);
+    writeFileSync3(filePath, content);
   }
 }
 if (!opts.install) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aixyz-app",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Payment-native SDK for AI Agent",
   "keywords": [
     "ai",
@@ -34,7 +34,7 @@
     "@types/bun": "^1.3.9",
     "@types/node": "^22",
     "ai": "^6",
-    "aixyz": "0.27.0",
+    "aixyz": "0.28.0",
     "typescript": "^5",
     "zod": "^4"
   }

package/templates/default/README.md

@@ -20,6 +20,20 @@ Open [http://localhost:3000/.well-known/agent-card.json](http://localhost:3000/.
 
 You can start editing the agent by modifying `app/agent.ts`. The server hot-reloads as you edit the file.
 
+## Testing
+
+Start the dev server:
+
+```bash
+bun run dev
+```
+
+Then in another terminal, use [use-agently](https://github.com/use-agently/cli) to interact with your agent via A2A:
+
+```bash
+bun use-agently a2a send --uri http://localhost:3000/ -m "Convert 100 meters to feet"
+```
+
 ## Learn More
 
 To learn more about aixyz, take a look at the following resources:

package/templates/default/package.json

@@ -8,11 +8,12 @@
   "dependencies": {
     "@ai-sdk/openai": "^3",
     "ai": "^6",
-    "aixyz": "0.27.0",
+    "aixyz": "0.28.0",
     "zod": "^4"
   },
   "devDependencies": {
     "@types/bun": "^1",
-    "typescript": "^5"
+    "typescript": "^5",
+    "use-agently": "latest"
   }
 }