@townco/cli 0.1.10 → 0.1.12

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/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>;