@andreprado/agentkit 0.1.0-alpha.24 → 0.1.0-alpha.25

package/README.md

@@ -24,12 +24,15 @@ Generated capsules use the built-in `test/fake` provider by default, so the firs
 ## What To Know First
 
 ```sh
-agentkit new <name> [--template blank|support|dentista] [--no-install]
+agentkit new [name] [--template blank|support|dentista] [--no-install]
+agentkit new .
 agentkit dev
 agentkit chat --message <text> [--conversation-id <id>]
 agentkit inspect
 ```
 
+Run `agentkit new` without a name in an interactive terminal to be prompted for the project folder. Use `agentkit new .` to create the capsule in the current directory.
+
 Once the capsule is running:
 
 ```sh

package/docs/guides/create-agent.md

@@ -39,6 +39,18 @@ cd support-demo
 npm run agentkit -- tool lookup_order --input '{"orderId":"A100"}'
 ```
 
+`agentkit new` can prompt for the project folder name when run in an interactive terminal:
+
+```sh
+npx @andreprado/agentkit@alpha new
+```
+
+Use `.` to create the capsule in the current directory:
+
+```sh
+npx @andreprado/agentkit@alpha new . --template blank
+```
+
 ## Windows PowerShell
 
 If PowerShell blocks `npm.ps1` or `npx.ps1` with `PSSecurityException`, run the same commands through the Windows command shims:

package/docs/llms-full.txt

@@ -33,7 +33,8 @@ The capsule root is the runtime boundary. Run AgentKit commands from the directo
 Current commands:
 
 ```sh
-agentkit new <name> [--template blank|support|dentista] [--no-install]
+agentkit new [name] [--template blank|support|dentista] [--no-install]
+agentkit new .
 agentkit dev [--port <number>]
 agentkit open
 agentkit chat-ui --deploy
@@ -139,6 +140,8 @@ npm run agentkit -- conversations list
 npm run agentkit -- inspect
 ```
 
+Run `agentkit new` without a name in an interactive terminal to be prompted for the project folder. Use `agentkit new .` to create the capsule in the current directory. Non-interactive scripts should pass a name or `.` explicitly.
+
 Expected first chat output:
 
 ```txt

package/docs/llms.txt

@@ -35,8 +35,9 @@ Task guides:
 Current local commands:
 
 ```sh
-agentkit new <name> --template blank|support|dentista
-agentkit new <name> --template blank --no-install
+agentkit new [name] --template blank|support|dentista
+agentkit new . --template blank
+agentkit new [name] --template blank --no-install
 agentkit docs full
 agentkit env set <NAME> --stdin
 agentkit env list

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andreprado/agentkit",
-  "version": "0.1.0-alpha.24",
+  "version": "0.1.0-alpha.25",
   "private": false,
   "type": "module",
   "repository": {

package/src/cli/help.ts

@@ -13,7 +13,7 @@ Usage:
   agentkit <command> [options]
 
 Start:
-  agentkit new <name> [--template blank|support|dentista] [--no-install]
+  agentkit new [name] [--template blank|support|dentista] [--no-install]
   agentkit dev
   agentkit open
   agentkit chat-ui --deploy
@@ -59,7 +59,7 @@ export function renderCommandReference(): string {
   return `AgentKit Command Reference
 
 Usage:
-  agentkit new <name> [--template blank|support|dentista] [--no-install]
+  agentkit new [name] [--template blank|support|dentista] [--no-install]
   agentkit dev [--port <number>]
   agentkit open
   agentkit chat-ui --deploy [--port <number>] [--token-file <path>]
@@ -189,13 +189,15 @@ Examples:
   agentkit tool lookup_order --input '{"orderId":"A100"}'
   agentkit eval run
 
+  agentkit new
+  agentkit new .
   agentkit new clara-dentista --template dentista
 `;
 }
 
 export function renderCommandHelp(command: string): string {
   const usage: Record<string, string> = {
-    new: "agentkit new <name> [--template blank|support|dentista] [--no-install]",
+    new: "agentkit new [name] [--template blank|support|dentista] [--no-install]",
     dev: "agentkit dev [--port <number>]",
     open: "agentkit open",
     "chat-ui": "agentkit chat-ui --deploy [--port <number>] [--token-file <path>]",

package/src/cli/index.ts

@@ -31,6 +31,7 @@ import { inspectAgentCapsule } from "../runtime/inspect";
 import { AgentKitError, isAgentKitError } from "../runtime/errors";
 import { prepareVpsDeploy } from "../runtime/targets/vps/deploy";
 import { parseArgs, isHelpRequested, type ParsedArgs } from "./args";
+import { resolveNewProjectName } from "./new-command";
 import {
   defaultAgentKitDevPort,
   defaultDeployChatAccessTokenName,
@@ -114,14 +115,10 @@ async function main() {
   warnIfUnsupportedNode();
 
   if (args.command === "new") {
-    const [name] = args.positional;
+    const name = await resolveNewProjectName(args.positional);
     const template = String(args.flags.template ?? "blank");
     const shouldInstall = args.flags["no-install"] !== true;
 
-    if (!name) {
-      throw new Error("Missing project name. Usage: agentkit new <name> [--template blank|support|dentista] [--no-install]");
-    }
-
     const result = await createProject({ name, template, cwd: process.cwd() });
     console.log(`Created ${result.name} at ${result.path}`);
 

package/src/cli/new-command.ts

@@ -0,0 +1,41 @@
+import { createInterface } from "node:readline/promises";
+
+const newUsage = "agentkit new [name] [--template blank|support|dentista] [--no-install]";
+
+export async function resolveNewProjectName(
+  positional: string[],
+  promptProjectName: () => Promise<string> = promptForProjectName,
+): Promise<string> {
+  const [name] = positional;
+
+  if (name) {
+    return name;
+  }
+
+  const promptedName = (await promptProjectName()).trim();
+
+  if (!promptedName) {
+    throw new Error(`Project name is required. Usage: ${newUsage}`);
+  }
+
+  return promptedName;
+}
+
+async function promptForProjectName(): Promise<string> {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error(
+      `Missing project name. Usage: ${newUsage}. Run \`agentkit new\` in an interactive terminal to be prompted, or pass \`agentkit new <name>\` / \`agentkit new .\` in scripts.`,
+    );
+  }
+
+  const readline = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    return await readline.question("Project folder name (or . for current directory): ");
+  } finally {
+    readline.close();
+  }
+}

package/src/templates/skills/agentkit-build-agent/SKILL.md

@@ -7,7 +7,7 @@ description: Use when the owner gives a natural-language brief for a new or chan
 
 Use this when the owner asks for an agent in plain language.
 
-The owner should only need to run `agentkit new <name>`, open the capsule in Codex or another coding agent, and say what agent they want. Do not send them back to the CLI for a brief wizard. Treat their chat message as the brief and build the first useful local capsule.
+The owner should only need to run `agentkit new [name]` or `agentkit new .`, open the capsule in Codex or another coding agent, and say what agent they want. Do not send them back to the CLI for a brief wizard. Treat their chat message as the brief and build the first useful local capsule.
 
 ## Workflow
 

package/src/templates/skills/agentkit-capsule/SKILL.md

@@ -9,7 +9,7 @@ Use this first inside an AgentKit Agent Capsule.
 
 ## Owner-To-Codex Contract
 
-The owner has already done the setup work by running `agentkit new <name>` and opening this folder in a coding agent. When they ask for an agent in natural language, that message is the brief.
+The owner has already done the setup work by running `agentkit new [name]` or `agentkit new .` and opening this folder in a coding agent. When they ask for an agent in natural language, that message is the brief.
 
 - Do not ask the owner to run a wizard, fill a form, or prepare `AGENT_SPEC.md`.
 - Route immediately to `skills/agentkit-build-agent/SKILL.md`.