@nicolasmondain/cli-agent 3.0.2

package/README.md

@@ -0,0 +1,183 @@
+# cli-agent
+
+> Turn your scripts into AI-powered tools
+
+cli-agent is an MCP server that lets AI assistants like Claude execute your scripts through natural language.
+
+## How it works
+
+1. You define your scripts in `.cli-agent.json`
+2. cli-agent exposes them as MCP tools
+3. Claude understands what they do and runs them when needed
+
+```
+User: "Deploy to staging"
+  ↓
+Claude matches intent → deploy --env staging
+  ↓
+Your script runs → Result returned to Claude
+```
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g @nicolasmondain/cli-agent
+```
+
+### 2. Create `.cli-agent.json`
+
+```json
+{
+  "name": "cli-agent",
+  "commands": [
+    {
+      "name": "deploy",
+      "description": "Deploy the app to staging or production",
+      "script": "./scripts/deploy.sh",
+      "options": [
+        { "flags": "-e, --env <env>", "choices": ["staging", "production"] }
+      ]
+    }
+  ]
+}
+```
+
+### 3. Configure Claude Code
+
+Add to your Claude Code MCP settings: `.claude/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "cli-agent": {
+      "command": "npx",
+      "args": ["cli-agent", "mcp:serve"]
+    }
+  }
+}
+```
+
+For Zed, add to your settings:
+
+```json
+{
+  "context_servers": {
+    "mcp-server-cli-agent": {
+      "command": "npx",
+      "args": ["@nicolasmondain/cli-agent", "mcp:serve"]
+    }
+  }
+}
+```
+
+Done. Claude can now run your scripts.
+
+## Writing Scripts
+
+Scripts can be JavaScript, TypeScript, or shell scripts.
+
+### JavaScript (.js)
+
+```javascript
+export default async function(context) {
+  const env = context.options.env;
+  // your logic here
+  return { success: true, message: `Deployed to ${env}` };
+}
+```
+
+### TypeScript (.ts)
+
+```typescript
+import type { ScriptContext, CommandResult } from '@nicolasmondain/cli-agent';
+
+export default async function(context: ScriptContext): Promise<CommandResult> {
+  const env = context.options.env as string;
+  return { success: true, message: `Deployed to ${env}` };
+}
+```
+
+### Shell (.sh)
+
+```bash
+#!/bin/bash
+ENV="${CLI_AGENT_OPT_ENV}"
+echo "Deploying to $ENV..."
+echo '{"success": true}'
+```
+
+## Configuration
+
+```json
+{
+  "name": "cli-agent",
+  "commands": [
+    {
+      "name": "command-name",
+      "description": "What this command does (helps Claude understand when to use it)",
+      "script": "./path/to/script.js",
+      "arguments": [
+        { "name": "arg", "description": "Positional argument", "required": true }
+      ],
+      "options": [
+        { "flags": "-o, --option <value>", "description": "Named option", "default": "value" }
+      ]
+    }
+  ]
+}
+```
+
+### Configuration locations
+
+cli-agent looks for configuration in this order:
+
+1. `--config <path>` flag
+2. `.cli-agent.json` in current directory
+3. `cli-agent` field in `package.json`
+4. `~/.cli-agent.json` (global)
+
+## CLI Usage
+
+```bash
+# Start MCP server (used by Claude Code)
+cli-agent mcp:serve
+
+# List available commands
+cli-agent list
+
+# Run a command directly
+cli-agent deploy --env staging
+
+# JSON output for scripting
+cli-agent deploy --env staging --format json
+```
+
+## Script Context
+
+Scripts receive a context object with:
+
+```typescript
+interface ScriptContext {
+  args: Record<string, unknown>;    // Positional arguments
+  options: Record<string, unknown>; // Named options
+  cwd: string;                      // Current working directory
+  format: 'human' | 'json';         // Output format
+}
+```
+
+Scripts must return:
+
+```typescript
+interface CommandResult {
+  success: boolean;
+  message?: string;  // Human-readable message
+  data?: unknown;    // Structured data
+  error?: string;    // Error message if success is false
+}
+```
+
+## License
+
+MIT

package/dist/cli/commands/list.command.d.ts

@@ -0,0 +1,48 @@
+/**
+ * List Command
+ *
+ * Built-in command that lists all available commands from configuration.
+ * Enables AI agents to discover commands dynamically.
+ */
+import { Command } from 'commander';
+import type { CliConfig } from '../../config/config-schema.js';
+import type { CommandResult } from '../../types/index.js';
+/**
+ * Data structure for list command output
+ */
+export interface ListCommandData {
+    name: string;
+    description?: string;
+    version?: string;
+    commands: Array<{
+        name: string;
+        description?: string;
+        script: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+            variadic?: boolean;
+        }>;
+        options?: Array<{
+            flags: string;
+            description?: string;
+            default?: unknown;
+            required?: boolean;
+            choices?: string[];
+        }>;
+    }>;
+}
+/**
+ * Create the list command result
+ */
+export declare function createListResult(config: CliConfig | null): CommandResult<ListCommandData | null>;
+/**
+ * Format list output for human display
+ */
+export declare function formatListHuman(config: CliConfig): string;
+/**
+ * Create the list command
+ */
+export declare function createListCommand(config: CliConfig | null): Command;
+//# sourceMappingURL=list.command.d.ts.map

package/dist/cli/commands/list.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,KAAK,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,aAAa,CAAC,eAAe,GAAG,IAAI,CAAC,CA0BhG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAwBzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAyBnE"}

package/dist/cli/commands/list.command.js

@@ -0,0 +1,87 @@
+/**
+ * List Command
+ *
+ * Built-in command that lists all available commands from configuration.
+ * Enables AI agents to discover commands dynamically.
+ */
+import { Command } from 'commander';
+import { outputResult } from '../../infra/output.js';
+/**
+ * Create the list command result
+ */
+export function createListResult(config) {
+    if (!config) {
+        return {
+            success: false,
+            error: 'No configuration found. Create a .cli-agent.json file to define commands.',
+        };
+    }
+    const data = {
+        name: config.name ?? 'cli-agent',
+        description: config.description,
+        version: config.version,
+        commands: config.commands.map((cmd) => ({
+            name: cmd.name,
+            description: cmd.description,
+            script: cmd.script,
+            arguments: cmd.arguments,
+            options: cmd.options,
+        })),
+    };
+    return {
+        success: true,
+        message: `Found ${config.commands.length} command(s)`,
+        data,
+    };
+}
+/**
+ * Format list output for human display
+ */
+export function formatListHuman(config) {
+    const lines = [];
+    lines.push(`Commands available in ${config.name ?? 'cli-agent'}:`);
+    lines.push('');
+    if (config.commands.length === 0) {
+        lines.push('  No commands defined.');
+    }
+    else {
+        // Find longest command name for alignment
+        const maxNameLength = Math.max(...config.commands.map((c) => c.name.length));
+        for (const cmd of config.commands) {
+            const padding = ' '.repeat(maxNameLength - cmd.name.length + 2);
+            const description = cmd.description ?? 'No description';
+            lines.push(`  ${cmd.name}${padding}${description}`);
+        }
+    }
+    lines.push('');
+    lines.push('Use "cli-agent <command> --help" for more information about a command.');
+    lines.push('Use "cli-agent list --format json" for machine-readable output.');
+    return lines.join('\n');
+}
+/**
+ * Create the list command
+ */
+export function createListCommand(config) {
+    const command = new Command('list');
+    command
+        .description('List all available commands')
+        .option('--format <format>', 'Output format: human or json', 'human')
+        .action((options) => {
+        const format = options.format === 'json' ? 'json' : 'human';
+        if (!config) {
+            const result = createListResult(null);
+            outputResult(result, format);
+            process.exit(1);
+            return;
+        }
+        if (format === 'json') {
+            const result = createListResult(config);
+            outputResult(result, format);
+        }
+        else {
+            console.log(formatListHuman(config));
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=list.command.js.map

package/dist/cli/commands/list.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.command.js","sourceRoot":"","sources":["../../../src/cli/commands/list.command.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/mcp-serve.command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Serve Command
+ *
+ * Built-in command that starts an MCP server exposing all configured
+ * cli-agent commands as MCP tools for Claude Code and other MCP clients.
+ */
+import { Command } from "commander";
+import type { CliConfig } from "../../config/config-schema.js";
+/**
+ * Create the mcp:serve command
+ */
+export declare function createMcpServeCommand(config: CliConfig | null, configDir: string | null): Command;
+//# sourceMappingURL=mcp-serve.command.d.ts.map

package/dist/cli/commands/mcp-serve.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-serve.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp-serve.command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,GAAG,IAAI,EACxB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAsCT"}

package/dist/cli/commands/mcp-serve.command.js

@@ -0,0 +1,42 @@
+/**
+ * MCP Serve Command
+ *
+ * Built-in command that starts an MCP server exposing all configured
+ * cli-agent commands as MCP tools for Claude Code and other MCP clients.
+ */
+import { Command } from "commander";
+import { startMcpServer } from "../../mcp/mcp-server.js";
+/**
+ * Create the mcp:serve command
+ */
+export function createMcpServeCommand(config, configDir) {
+    const command = new Command("mcp:serve");
+    command
+        .description("Start MCP server exposing all commands as tools")
+        .action(async () => {
+        if (!config) {
+            console.error("Error: No configuration found. Create a .cli-agent.json file to define commands.");
+            process.exit(1);
+            return;
+        }
+        if (config.commands.length === 0) {
+            console.error("Error: No commands defined in configuration.");
+            process.exit(1);
+            return;
+        }
+        if (!configDir) {
+            console.error("Error: Configuration directory not available.");
+            process.exit(1);
+            return;
+        }
+        try {
+            await startMcpServer({ config, configDir });
+        }
+        catch (error) {
+            console.error("Error starting MCP server:", error instanceof Error ? error.message : String(error));
+            process.exit(1);
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=mcp-serve.command.js.map

package/dist/cli/commands/mcp-serve.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-serve.command.js","sourceRoot":"","sources":["../../../src/cli/commands/mcp-serve.command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAwB,EACxB,SAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzC,OAAO;SACJ,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CACX,kFAAkF,CACnF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,4BAA4B,EAC5B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ *
+ * MCP server that turns your scripts into AI-powered tools.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/cli/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ *
+ * MCP server that turns your scripts into AI-powered tools.
+ */
+import { Command } from "commander";
+import { loadConfig, getExplicitConfigPath } from "../config/config-loader.js";
+import { createDynamicCommand } from "../command/dynamic-command.factory.js";
+import { createListCommand } from "./commands/list.command.js";
+import { createMcpServeCommand } from "./commands/mcp-serve.command.js";
+import { logError, logDebug } from "../infra/logger.js";
+// Package info
+const VERSION = "2.0.0";
+const DEFAULT_NAME = "cli-agent";
+const DEFAULT_DESCRIPTION = "MCP server that turns your scripts into AI-powered tools";
+/**
+ * Create and configure the main CLI program
+ */
+async function createProgram() {
+    const program = new Command();
+    // Try to load configuration
+    const explicitPath = getExplicitConfigPath();
+    const configResult = await loadConfig(explicitPath);
+    const config = configResult?.config ?? null;
+    if (configResult) {
+        const { config, configDir, configPath } = configResult;
+        program
+            .name(config.name ?? DEFAULT_NAME)
+            .description(config.description ?? DEFAULT_DESCRIPTION)
+            .version(config.version ?? VERSION, "-v, --version", "Output the current version");
+        // Register all commands from configuration
+        for (const commandConfig of config.commands) {
+            const command = createDynamicCommand(commandConfig, configDir);
+            program.addCommand(command);
+        }
+        logDebug("Loaded configuration", {
+            path: configPath,
+            commandCount: config.commands.length,
+            commands: config.commands.map((c) => c.name),
+        });
+    }
+    else {
+        // No configuration found - show helpful message
+        program
+            .name(DEFAULT_NAME)
+            .description(DEFAULT_DESCRIPTION)
+            .version(VERSION, "-v, --version", "Output the current version");
+        program.addHelpText("after", `
+No configuration file found. Create one of:
+  - .cli-agent.json in your project
+  - "cli-agent" field in package.json
+  - ~/.cli-agent.json for global commands
+
+Example .cli-agent.json:
+{
+  "name": "my-cli",
+  "commands": [
+    {
+      "name": "hello",
+      "description": "Say hello",
+      "script": "./scripts/hello.js",
+      "options": [
+        { "flags": "-n, --name <name>", "description": "Name to greet" }
+      ]
+    }
+  ]
+}
+
+Example script (./scripts/hello.js):
+export default async function(context) {
+  const name = context.options.name || 'World';
+  return {
+    success: true,
+    message: \`Hello, \${name}!\`
+  };
+}
+`);
+    }
+    // Add built-in commands (always available)
+    program.addCommand(createListCommand(config));
+    program.addCommand(createMcpServeCommand(config, configResult?.configDir ?? null));
+    // Add global options
+    program
+        .option("-c, --config <path>", "Path to configuration file")
+        .helpOption("-h, --help", "Display help for command");
+    return program;
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    try {
+        const program = await createProgram();
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        logError("Unexpected error:", error);
+        // Output error in JSON format if possible
+        if (process.argv.includes("--format") && process.argv.includes("json")) {
+            console.log(JSON.stringify({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        }
+        process.exit(1);
+    }
+}
+// Run the CLI
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/command/dynamic-command.factory.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Dynamic Command Factory
+ *
+ * Creates Commander.js commands from configuration.
+ */
+import { Command } from "commander";
+import type { CommandConfig } from "../config/config-schema.js";
+/**
+ * Create a Commander command from configuration
+ *
+ * @param config - Command configuration from CLI config file
+ * @param configDir - Directory containing the configuration file
+ * @returns Configured Commander command
+ */
+export declare function createDynamicCommand(config: CommandConfig, configDir: string): Command;
+//# sourceMappingURL=dynamic-command.factory.d.ts.map

package/dist/command/dynamic-command.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-command.factory.d.ts","sourceRoot":"","sources":["../../src/command/dynamic-command.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,4BAA4B,CAAC;AAShF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAiHT"}