@townco/cli 0.1.3 → 0.1.5

package/dist/commands/mcp-list.js

@@ -0,0 +1,188 @@
+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",
+				}),
+			}),
+		],
+	});
+}
+// ============================================================================
+// 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");
+	}
+}

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

@@ -0,0 +1,3 @@
+declare function MCPRemoveApp(): import("react/jsx-runtime").JSX.Element;
+export default MCPRemoveApp;
+export declare function runMCPRemove(): Promise<void>;

package/dist/commands/mcp-remove.js

@@ -0,0 +1,208 @@
+import { SingleSelect } from "@town/ui/tui";
+import { Box, render, Text } from "ink";
+import { useEffect, useState } from "react";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import {
+	deleteMCPConfig,
+	getMCPSummary,
+	listMCPConfigs,
+} from "../lib/mcp-storage";
+
+// ============================================================================
+// Main Component
+// ============================================================================
+function MCPRemoveApp() {
+	const [stage, setStage] = useState("loading");
+	const [configs, setConfigs] = useState([]);
+	const [selectedName, setSelectedName] = useState(null);
+	const [selectedConfig, setSelectedConfig] = useState(null);
+	const [errorMessage, setErrorMessage] = useState("");
+	// Load configs on mount
+	useEffect(() => {
+		function loadConfigs() {
+			try {
+				const configList = listMCPConfigs();
+				setConfigs(configList);
+				setStage(configList.length > 0 ? "select" : "error");
+				if (configList.length === 0) {
+					setErrorMessage("No MCP servers configured");
+				}
+			} catch (error) {
+				const errorMsg = error instanceof Error ? error.message : String(error);
+				setErrorMessage(errorMsg);
+				setStage("error");
+			}
+		}
+		loadConfigs();
+	}, []);
+	// Handle removal
+	const handleRemove = () => {
+		if (!selectedName) return;
+		setStage("removing");
+		try {
+			const success = deleteMCPConfig(selectedName);
+			if (success) {
+				setStage("done");
+				// Exit immediately
+				process.exit(0);
+			} else {
+				throw new Error("Failed to delete MCP config");
+			}
+		} catch (error) {
+			const errorMsg = error instanceof Error ? error.message : String(error);
+			setErrorMessage(errorMsg);
+			setStage("error");
+		}
+	};
+	if (stage === "loading") {
+		return _jsx(Box, {
+			children: _jsx(Text, { children: "Loading MCP servers..." }),
+		});
+	}
+	if (stage === "error") {
+		return _jsxs(Box, {
+			flexDirection: "column",
+			children: [
+				_jsx(Box, {
+					marginBottom: 1,
+					children: _jsx(Text, {
+						bold: true,
+						color: "red",
+						children: "\u274C Error",
+					}),
+				}),
+				_jsx(Box, { children: _jsx(Text, { children: errorMessage }) }),
+			],
+		});
+	}
+	if (stage === "select") {
+		const options = configs.map((config) => ({
+			label: config.name,
+			value: config.name,
+			description: getMCPSummary(config),
+		}));
+		return _jsxs(Box, {
+			flexDirection: "column",
+			children: [
+				_jsx(Box, {
+					marginBottom: 1,
+					children: _jsx(Text, {
+						bold: true,
+						children: "Select MCP server to remove",
+					}),
+				}),
+				_jsx(SingleSelect, {
+					options: options,
+					selected: selectedName,
+					onChange: setSelectedName,
+					onSubmit: (name) => {
+						const found = configs.find((c) => c.name === name);
+						if (found) {
+							setSelectedName(name);
+							setSelectedConfig(found);
+							setStage("confirm");
+						}
+					},
+					onCancel: () => process.exit(0),
+				}),
+			],
+		});
+	}
+	if (stage === "confirm") {
+		return _jsxs(Box, {
+			flexDirection: "column",
+			children: [
+				_jsx(Box, {
+					marginBottom: 1,
+					children: _jsx(Text, { bold: true, children: "Confirm removal" }),
+				}),
+				_jsx(Box, {
+					marginBottom: 1,
+					children: _jsxs(Text, {
+						children: [
+							"Are you sure you want to remove:",
+							" ",
+							_jsx(Text, { bold: true, children: selectedConfig?.name }),
+						],
+					}),
+				}),
+				_jsx(Box, {
+					marginBottom: 1,
+					children: _jsx(Text, {
+						dimColor: true,
+						children: getMCPSummary(selectedConfig),
+					}),
+				}),
+				_jsx(SingleSelect, {
+					options: [
+						{
+							label: "Yes, remove it",
+							value: "yes",
+							description: "Permanently delete this MCP server configuration",
+						},
+						{
+							label: "No, cancel",
+							value: "no",
+							description: "Go back to selection",
+						},
+					],
+					selected: null,
+					onChange: () => {},
+					onSubmit: (choice) => {
+						if (choice === "yes") {
+							handleRemove();
+						} else {
+							setStage("select");
+						}
+					},
+					onCancel: () => setStage("select"),
+				}),
+			],
+		});
+	}
+	if (stage === "removing") {
+		return _jsx(Box, {
+			children: _jsx(Text, {
+				children: "\uD83D\uDDD1\uFE0F Removing MCP server...",
+			}),
+		});
+	}
+	if (stage === "done") {
+		return _jsxs(Box, {
+			flexDirection: "column",
+			children: [
+				_jsx(Box, {
+					marginBottom: 1,
+					children: _jsx(Text, {
+						bold: true,
+						color: "green",
+						children: "\u2705 MCP server removed successfully",
+					}),
+				}),
+				_jsx(Box, {
+					children: _jsxs(Text, {
+						children: [
+							"Removed: ",
+							_jsx(Text, { bold: true, children: selectedConfig?.name }),
+						],
+					}),
+				}),
+			],
+		});
+	}
+	return _jsxs(Text, { children: ["Unknown stage: ", stage] });
+}
+// ============================================================================
+// Export and Runner
+// ============================================================================
+export default MCPRemoveApp;
+export async function runMCPRemove() {
+	const { waitUntilExit, clear } = render(_jsx(MCPRemoveApp, {}));
+	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/run.js

@@ -1,8 +1,38 @@
 import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import { join } from "node:path";
-import { agentExists, getAgentPath } from "@townco/agent/storage";
+import { agentExists, getAgentPath } from "@town/agent/storage";
+import open from "open";
+async function loadEnvVars() {
+    const envPath = join(homedir(), ".config", "town", ".env");
+    const envVars = {};
+    if (!existsSync(envPath)) {
+        return envVars;
+    }
+    try {
+        const content = await readFile(envPath, "utf-8");
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const [key, ...valueParts] = trimmed.split("=");
+            const value = valueParts.join("=").trim();
+            if (key && value) {
+                envVars[key.trim()] = value;
+            }
+        }
+    }
+    catch (_error) {
+        console.warn(`Warning: Could not load environment variables from ${envPath}`);
+    }
+    return envVars;
+}
 export async function runCommand(options) {
     const { name, http = false, gui = false, port = 3100 } = options;
+    // Load environment variables from ~/.config/town/.env
+    const configEnvVars = await loadEnvVars();
     // Check if agent exists
     const exists = await agentExists(name);
     if (!exists) {
@@ -35,6 +65,7 @@ export async function runCommand(options) {
             stdio: "pipe",
             env: {
                 ...process.env,
+                ...configEnvVars,
                 NODE_ENV: process.env.NODE_ENV || "production",
                 PORT: port.toString(),
             },
@@ -51,6 +82,7 @@ export async function runCommand(options) {
                 stdio: "inherit",
                 env: {
                     ...process.env,
+                    ...configEnvVars,
                     VITE_AGENT_URL: `http://localhost:${port}`,
                 },
             });
@@ -66,6 +98,15 @@ export async function runCommand(options) {
                     process.exit(code);
                 }
             });
+            // Open browser after GUI server has time to start (default Vite port is 5173)
+            setTimeout(() => {
+                const guiUrl = "http://localhost:5173";
+                console.log(`Opening browser at ${guiUrl}...`);
+                open(guiUrl).catch((error) => {
+                    console.warn(`Could not automatically open browser: ${error.message}`);
+                    console.log(`Please manually open: ${guiUrl}`);
+                });
+            }, 2000);
         }, 1000);
         agentProcess.on("close", (code) => {
             if (code !== 0 && code !== null) {
@@ -87,6 +128,7 @@ export async function runCommand(options) {
             stdio: "inherit",
             env: {
                 ...process.env,
+                ...configEnvVars,
                 NODE_ENV: process.env.NODE_ENV || "production",
                 PORT: port.toString(),
             },
@@ -105,18 +147,15 @@ export async function runCommand(options) {
     }
     // Default: Start TUI interface with the agent
     console.log(`Starting interactive terminal for agent "${name}"...\n`);
-    // Get path to TUI app from CLI package
-    const { fileURLToPath } = await import("node:url");
-    const { dirname } = await import("node:path");
-    const currentFile = fileURLToPath(import.meta.url);
-    const cliRoot = join(dirname(currentFile), "..", "..");
-    const tuiPath = join(cliRoot, "tui", "index.js");
+    // Get path to TUI app
+    const tuiPath = join(process.cwd(), "apps", "tui", "src", "index.tsx");
     // Run TUI with the agent
     const tuiProcess = spawn("bun", [tuiPath, "--agent", binPath], {
         cwd: agentPath,
         stdio: "inherit",
         env: {
             ...process.env,
+            ...configEnvVars,
             NODE_ENV: process.env.NODE_ENV || "production",
         },
     });

package/dist/index.js

@@ -3,13 +3,17 @@ import { argument, command, constant, flag, multiple, object, option, optional,
 import { message } from "@optique/core/message";
 import { integer, string } from "@optique/core/valueparser";
 import { run } from "@optique/run";
-import { createSecret, deleteSecret, genenv, listSecrets } from "@townco/secret";
+import { createSecret, deleteSecret, genenv, listSecrets } from "@town/secret";
 import inquirer from "inquirer";
 import { match } from "ts-pattern";
+import { configureCommand } from "./commands/configure.js";
 import { createCommand } from "./commands/create.js";
 import { deleteCommand } from "./commands/delete.js";
 import { editCommand } from "./commands/edit.js";
 import { listCommand } from "./commands/list.js";
+import { runMCPAdd } from "./commands/mcp-add.js";
+import { runMCPList } from "./commands/mcp-list.js";
+import { runMCPRemove } from "./commands/mcp-remove.js";
 import { runCommand } from "./commands/run.js";
 /**
  * Securely prompt for a secret value without echoing to the terminal
@@ -25,7 +29,9 @@ async function promptSecret(secretName) {
     ]);
     return answers.value;
 }
-const parser = or(command("deploy", constant("deploy"), { brief: message `Deploy a Town.` }), command("create", object({
+const parser = or(command("deploy", constant("deploy"), { brief: message `Deploy a Town.` }), command("configure", constant("configure"), {
+    brief: message `Configure environment variables.`,
+}), command("create", object({
     command: constant("create"),
     name: optional(option("-n", "--name", string())),
     model: optional(option("-m", "--model", string())),
@@ -43,7 +49,20 @@ const parser = or(command("deploy", constant("deploy"), { brief: message `Deploy
 }), { brief: message `Edit an agent.` }), command("delete", object({
     command: constant("delete"),
     name: argument(string({ metavar: "NAME" })),
-}), { brief: message `Delete an agent.` }), command("secret", object({
+}), { brief: message `Delete an agent.` }), command("mcp", object({
+    command: constant("mcp"),
+    subcommand: or(command("add", object({
+        action: constant("add"),
+        name: optional(option("-n", "--name", string())),
+        url: optional(option("-u", "--url", string())),
+        command: optional(option("-c", "--command", string())),
+        args: multiple(option("-a", "--arg", string())),
+    }), { brief: message `Add a new MCP server.` }), command("list", constant("list"), {
+        brief: message `List all configured MCP servers.`,
+    }), command("remove", constant("remove"), {
+        brief: message `Remove an MCP server.`,
+    })),
+}), { brief: message `Manage MCP (Model Context Protocol) servers.` }), command("secret", object({
     command: constant("secret"),
     subcommand: or(command("list", constant("list"), { brief: message `List secrets.` }), command("add", object({
         action: constant("add"),
@@ -69,6 +88,9 @@ async function main(parser, meta) {
     await match(result)
         // TODO
         .with("deploy", async () => { })
+        .with("configure", async () => {
+        await configureCommand();
+    })
         .with({ command: "create" }, async ({ name, model, tools, systemPrompt }) => {
         // Create command starts a long-running Ink session
         // Only pass defined properties to satisfy exactOptionalPropertyTypes
@@ -98,6 +120,20 @@ async function main(parser, meta) {
     })
         .with({ command: "delete" }, async ({ name }) => {
         await deleteCommand(name);
+    })
+        .with({ command: "mcp" }, async ({ subcommand }) => {
+        await match(subcommand)
+            .with({ action: "add" }, async ({ name, url, command, args }) => {
+            await runMCPAdd({
+                ...(name !== undefined && { name }),
+                ...(url !== undefined && { url }),
+                ...(command !== undefined && { command }),
+                ...(args.length > 0 && { args }),
+            });
+        })
+            .with("list", async () => await runMCPList())
+            .with("remove", async () => await runMCPRemove())
+            .exhaustive();
     })
         .with({ command: "secret" }, async ({ subcommand }) => {
         await match(subcommand)

package/dist/lib/mcp-storage.d.ts

@@ -0,0 +1,31 @@
+export type MCPConfig = {
+	name: string;
+	transport: "stdio" | "http";
+	command?: string;
+	args?: string[];
+	url?: string;
+};
+/**
+ * Save an MCP config to the store
+ */
+export declare function saveMCPConfig(config: MCPConfig): void;
+/**
+ * Load an MCP config by name
+ */
+export declare function loadMCPConfig(name: string): MCPConfig | null;
+/**
+ * Delete an MCP config by name
+ */
+export declare function deleteMCPConfig(name: string): boolean;
+/**
+ * List all MCP configs
+ */
+export declare function listMCPConfigs(): MCPConfig[];
+/**
+ * Check if an MCP config exists
+ */
+export declare function mcpConfigExists(name: string): boolean;
+/**
+ * Get a summary of an MCP config for display
+ */
+export declare function getMCPSummary(config: MCPConfig): string;