@townco/cli 0.1.11 → 0.1.13

package/README.md

@@ -0,0 +1,66 @@
+# Town CLI
+
+Run AI agents from the command line.
+
+## Quick Start
+
+```bash
+npx @townco/cli configure              # Set up API keys
+npx @townco/cli create
+npx @townco/cli run my-agent           # Run in terminal (TUI)
+npx @townco/cli run my-agent --gui     # Run with web interface
+```
+
+## Commands
+
+### `create [name]` - Create an agent
+
+```bash
+npx @townco/cli create                 # Interactive wizard
+npx @townco/cli create --name my-agent        # With name
+npx @townco/cli create \
+  --name my-agent \
+  --model claude-sonnet-4-5-20250929 \
+  --tools web_search,todo_write \
+  --system-prompt "You are a helpful assistant"
+```
+
+### `list` - List all agents
+
+```bash
+npx @townco/cli list
+```
+
+### `configure` - Set up API keys
+
+```bash
+npx @townco/cli configure
+```
+
+Sets `ANTHROPIC_API_KEY`, `EXA_API_KEY`, etc. in `~/.config/town/.env`
+
+### `run <name>` - Run an agent
+
+```bash
+npx @townco/cli run my-agent           # TUI mode (default)
+npx @townco/cli run my-agent --gui     # Web interface
+npx @townco/cli run my-agent --http    # HTTP API server
+npx @townco/cli run my-agent --http --port 8080
+```
+
+### `delete <name>` - Delete an agent
+
+```bash
+npx @townco/cli delete my-agent
+```
+
+## Models
+
+- `claude-sonnet-4-5-20250929` - Latest (recommended)
+- `claude-opus-4-20250514` - Most capable
+- `claude-3-5-haiku-20241022` - Fastest
+
+## Tools
+
+- `todo_write` - Task management
+- `web_search` - Web search (requires EXA_API_KEY)

package/dist/commands/create.d.ts

@@ -1,8 +1,9 @@
 interface CreateCommandProps {
-	name?: string;
-	model?: string;
-	tools?: readonly string[];
-	systemPrompt?: string;
-	overwrite?: boolean;
+    name?: string;
+    model?: string;
+    tools?: readonly string[];
+    systemPrompt?: string;
+    overwrite?: boolean;
 }
 export declare function createCommand(props: CreateCommandProps): Promise<void>;
+export {};

package/dist/commands/create.js

@@ -1,13 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { spawn } from "node:child_process";
-import { readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
 import { scaffoldAgent } from "@townco/agent/scaffold";
 import { InputBox, MultiSelect, SingleSelect } from "@townco/ui/tui";
 import { Box, render, Text, useInput } from "ink";
 import TextInput from "ink-text-input";
 import { useEffect, useState } from "react";
+import { openInEditor } from "../lib/editor-utils";
 const AVAILABLE_MODELS = [
     {
         label: "Claude Sonnet 4.5",
@@ -55,70 +52,6 @@ function NameInput({ nameInput, setNameInput, onSubmit }) {
     });
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "Enter agent name:" }) }), _jsxs(Box, { children: [_jsxs(Text, { children: [">", " "] }), _jsx(TextInput, { value: nameInput, onChange: setNameInput, onSubmit: onSubmit })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Enter: Continue \u2022 Esc: Cancel" }) })] }));
 }
-async function openEditor(initialContent) {
-    const tempFile = join(tmpdir(), `agent-prompt-${Date.now()}.txt`);
-    try {
-        // Write initial content
-        writeFileSync(tempFile, initialContent, "utf-8");
-        // Try $EDITOR first
-        const editor = process.env.EDITOR;
-        if (editor) {
-            try {
-                await new Promise((resolve, reject) => {
-                    const child = spawn(editor, [tempFile], {
-                        stdio: "inherit",
-                    });
-                    child.on("close", (code) => {
-                        if (code === 0)
-                            resolve();
-                        else
-                            reject(new Error(`Editor exited with code ${code}`));
-                    });
-                    child.on("error", reject);
-                });
-                const content = readFileSync(tempFile, "utf-8");
-                unlinkSync(tempFile);
-                return content;
-            }
-            catch (_error) {
-                // Fall through to try 'code'
-            }
-        }
-        // Try 'code' (VS Code) as fallback
-        try {
-            await new Promise((resolve, reject) => {
-                const child = spawn("code", ["--wait", tempFile], {
-                    stdio: "inherit",
-                });
-                child.on("close", (code) => {
-                    if (code === 0)
-                        resolve();
-                    else
-                        reject(new Error(`Code exited with code ${code}`));
-                });
-                child.on("error", reject);
-            });
-            const content = readFileSync(tempFile, "utf-8");
-            unlinkSync(tempFile);
-            return content;
-        }
-        catch (_error) {
-            // Clean up and return null to signal fallback to inline
-            unlinkSync(tempFile);
-            return null;
-        }
-    }
-    catch (_error) {
-        // Clean up temp file if it exists
-        try {
-            unlinkSync(tempFile);
-        }
-        catch {
-            // Ignore cleanup errors
-        }
-        return null;
-    }
-}
 function CreateApp({ name: initialName, model: initialModel, tools: initialTools, systemPrompt: initialSystemPrompt, overwrite = false, }) {
     // Determine the starting stage based on what's provided
     const determineInitialStage = () => {
@@ -150,13 +83,14 @@ function CreateApp({ name: initialName, model: initialModel, tools: initialTools
     const [agentPath, setAgentPath] = useState(null);
     // Handle opening editor when systemPrompt stage is entered from review
     useEffect(() => {
-        if (stage === "systemPrompt" &&
-            isEditingFromReview &&
-            !isEditingPrompt &&
-            promptEditMode === null) {
-            // Trigger editor opening
-            setIsEditingPrompt(true);
-            openEditor(agentDef.systemPrompt || "You are a helpful assistant.").then((editorContent) => {
+        (async () => {
+            if (stage === "systemPrompt" &&
+                isEditingFromReview &&
+                !isEditingPrompt &&
+                promptEditMode === null) {
+                // Trigger editor opening
+                setIsEditingPrompt(true);
+                const editorContent = await openInEditor(agentDef.systemPrompt || "You are a helpful assistant.");
                 if (editorContent !== null) {
                     // Editor worked
                     setAgentDef({ ...agentDef, systemPrompt: editorContent });
@@ -170,8 +104,8 @@ function CreateApp({ name: initialName, model: initialModel, tools: initialTools
                     setIsEditingPrompt(false);
                     setSystemPromptInput(agentDef.systemPrompt || "You are a helpful assistant.");
                 }
-            });
-        }
+            }
+        })();
     }, [stage, isEditingFromReview, isEditingPrompt, promptEditMode, agentDef]);
     // Handle scaffolding when entering "done" stage
     useEffect(() => {
@@ -271,7 +205,7 @@ function CreateApp({ name: initialName, model: initialModel, tools: initialTools
                         setStage("systemPrompt");
                         // Attempt to open editor
                         setIsEditingPrompt(true);
-                        const editorContent = await openEditor(agentDef.systemPrompt || "You are a helpful assistant.");
+                        const editorContent = await openInEditor(agentDef.systemPrompt || "You are a helpful assistant.");
                         if (editorContent !== null) {
                             // Editor worked
                             setAgentDef({ ...agentDef, systemPrompt: editorContent });

package/dist/commands/mcp-add.d.ts

@@ -1,14 +1,9 @@
 interface MCPAddProps {
-	name?: string;
-	url?: string;
-	command?: string;
-	args?: readonly string[];
+    name?: string;
+    url?: string;
+    command?: string;
+    args?: readonly string[];
 }
-declare function MCPAddApp({
-	name: initialName,
-	url: initialUrl,
-	command: initialCommand,
-	args: initialArgs,
-}: MCPAddProps): import("react/jsx-runtime").JSX.Element | null;
+declare function MCPAddApp({ name: initialName, url: initialUrl, command: initialCommand, args: initialArgs, }: MCPAddProps): import("react/jsx-runtime").JSX.Element | null;
 export default MCPAddApp;
 export declare function runMCPAdd(props?: MCPAddProps): Promise<void>;

package/dist/commands/mcp-list.js

@@ -1,188 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, render, Text, useApp, useInput } from "ink";
 import { useEffect, useState } from "react";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { listMCPConfigs } from "../lib/mcp-storage";
-
 // ============================================================================
 // Main Component
 // ============================================================================
 function MCPListApp() {
-	const [result, setResult] = useState(null);
-	const [loading, setLoading] = useState(true);
-	const { exit } = useApp();
-	useEffect(() => {
-		function loadConfigs() {
-			try {
-				const configs = listMCPConfigs();
-				setResult({ configs });
-			} catch (error) {
-				const errorMsg = error instanceof Error ? error.message : String(error);
-				setResult({ configs: [], error: errorMsg });
-			} finally {
-				setLoading(false);
-			}
-		}
-		loadConfigs();
-	}, []);
-	// Exit on any key press when not loading
-	useInput((_input, key) => {
-		if (!loading) {
-			if (key.return || key.escape || _input === "q") {
-				exit();
-			}
-		}
-	});
-	if (loading) {
-		return _jsx(Box, {
-			children: _jsx(Text, { children: "Loading MCP servers..." }),
-		});
-	}
-	if (result?.error) {
-		return _jsxs(Box, {
-			flexDirection: "column",
-			children: [
-				_jsx(Box, {
-					marginBottom: 1,
-					children: _jsx(Text, {
-						bold: true,
-						color: "red",
-						children: "\u274C Error loading MCP servers",
-					}),
-				}),
-				_jsx(Box, {
-					marginBottom: 1,
-					children: _jsx(Text, { children: result.error }),
-				}),
-				_jsx(Box, {
-					children: _jsx(Text, {
-						dimColor: true,
-						children: "Press Enter or Q to exit",
-					}),
-				}),
-			],
-		});
-	}
-	if (!result || result.configs.length === 0) {
-		return _jsxs(Box, {
-			flexDirection: "column",
-			children: [
-				_jsx(Box, {
-					marginBottom: 1,
-					children: _jsx(Text, {
-						bold: true,
-						children: "No MCP servers configured",
-					}),
-				}),
-				_jsx(Box, {
-					marginBottom: 1,
-					children: _jsx(Text, {
-						dimColor: true,
-						children: "Add one with: town mcp add",
-					}),
-				}),
-				_jsx(Box, {
-					children: _jsx(Text, {
-						dimColor: true,
-						children: "Press Enter or Q to exit",
-					}),
-				}),
-			],
-		});
-	}
-	return _jsxs(Box, {
-		flexDirection: "column",
-		children: [
-			_jsx(Box, {
-				marginBottom: 1,
-				children: _jsxs(Text, {
-					bold: true,
-					children: ["Configured MCP Servers (", result.configs.length, ")"],
-				}),
-			}),
-			result.configs.map((config, index) =>
-				_jsxs(
-					Box,
-					{
-						flexDirection: "column",
-						marginBottom: 1,
-						children: [
-							_jsx(Box, {
-								children: _jsxs(Text, {
-									bold: true,
-									color: "cyan",
-									children: [index + 1, ". ", config.name],
-								}),
-							}),
-							_jsx(Box, {
-								paddingLeft: 3,
-								children:
-									config.transport === "http"
-										? _jsxs(Box, {
-												flexDirection: "column",
-												children: [
-													_jsxs(Text, {
-														children: [
-															"Transport: ",
-															_jsx(Text, { color: "green", children: "HTTP" }),
-														],
-													}),
-													_jsxs(Text, { children: ["URL: ", config.url] }),
-												],
-											})
-										: _jsxs(Box, {
-												flexDirection: "column",
-												children: [
-													_jsxs(Text, {
-														children: [
-															"Transport: ",
-															_jsx(Text, { color: "blue", children: "stdio" }),
-														],
-													}),
-													_jsxs(Text, {
-														children: ["Command: ", config.command],
-													}),
-													config.args &&
-														config.args.length > 0 &&
-														_jsxs(Text, {
-															children: ["Args: ", config.args.join(" ")],
-														}),
-												],
-											}),
-							}),
-						],
-					},
-					config.name,
-				),
-			),
-			_jsx(Box, {
-				marginTop: 1,
-				children: _jsx(Text, {
-					dimColor: true,
-					children:
-						"Use `town mcp remove` to remove a server or `town mcp add` to add one",
-				}),
-			}),
-			_jsx(Box, {
-				marginTop: 1,
-				children: _jsx(Text, {
-					dimColor: true,
-					children: "Press Enter or Q to exit",
-				}),
-			}),
-		],
-	});
+    const [result, setResult] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const { exit } = useApp();
+    useEffect(() => {
+        function loadConfigs() {
+            try {
+                const configs = listMCPConfigs();
+                setResult({ configs });
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                setResult({ configs: [], error: errorMsg });
+            }
+            finally {
+                setLoading(false);
+            }
+        }
+        loadConfigs();
+    }, []);
+    // Exit on any key press when not loading
+    useInput((_input, key) => {
+        if (!loading) {
+            if (key.return || key.escape || _input === "q") {
+                exit();
+            }
+        }
+    });
+    if (loading) {
+        return (_jsx(Box, { children: _jsx(Text, { children: "Loading MCP servers..." }) }));
+    }
+    if (result?.error) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "red", children: "\u274C Error loading MCP servers" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: result.error }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: "Press Enter or Q to exit" }) })] }));
+    }
+    if (!result || result.configs.length === 0) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "No MCP servers configured" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { dimColor: true, children: "Add one with: town mcp add" }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: "Press Enter or Q to exit" }) })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { bold: true, children: ["Configured MCP Servers (", result.configs.length, ")"] }) }), result.configs.map((config, index) => (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { children: _jsxs(Text, { bold: true, color: "cyan", children: [index + 1, ". ", config.name] }) }), _jsx(Box, { paddingLeft: 3, children: config.transport === "http" ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Transport: ", _jsx(Text, { color: "green", children: "HTTP" })] }), _jsxs(Text, { children: ["URL: ", config.url] })] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Transport: ", _jsx(Text, { color: "blue", children: "stdio" })] }), _jsxs(Text, { children: ["Command: ", config.command] }), config.args && config.args.length > 0 && (_jsxs(Text, { children: ["Args: ", config.args.join(" ")] }))] })) })] }, config.name))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Use `town mcp remove` to remove a server or `town mcp add` to add one" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Press Enter or Q to exit" }) })] }));
 }
 // ============================================================================
 // Export and Runner
 // ============================================================================
 export default MCPListApp;
 export async function runMCPList() {
-	const { waitUntilExit, clear } = render(_jsx(MCPListApp, {}));
-	try {
-		await waitUntilExit();
-	} finally {
-		clear();
-		// Ensure cursor is visible
-		process.stdout.write("\x1B[?25h");
-	}
+    const { waitUntilExit, clear } = render(_jsx(MCPListApp, {}));
+    try {
+        await waitUntilExit();
+    }
+    finally {
+        clear();
+        // Ensure cursor is visible
+        process.stdout.write("\x1B[?25h");
+    }
 }

package/dist/commands/run.d.ts

@@ -1,7 +1,7 @@
 export interface RunCommandOptions {
-	name: string;
-	http?: boolean;
-	gui?: boolean;
-	port?: number;
+    name: string;
+    http?: boolean;
+    gui?: boolean;
+    port?: number;
 }
 export declare function runCommand(options: RunCommandOptions): Promise<void>;

package/dist/commands/tool-add.d.ts

@@ -0,0 +1,6 @@
+interface ToolAddProps {
+    name?: string;
+}
+declare function ToolAddApp({ name: initialName }: ToolAddProps): import("react/jsx-runtime").JSX.Element | null;
+export default ToolAddApp;
+export declare function runToolAdd(props?: ToolAddProps): Promise<void>;