@mks2508/coolify-mks-cli-mcp 0.4.3 → 0.6.0

package/src/cli/index.ts

@@ -7,176 +7,451 @@
  * @module
  */
 
-import { Command } from 'commander'
-import chalk from 'chalk'
-import { createCommand } from './commands/create.js'
-import { deployCommand } from './commands/deploy.js'
-import { listCommand } from './commands/list.js'
-import { logsCommand } from './commands/logs.js'
-import { serversCommand } from './commands/servers.js'
-import { projectsCommand } from './commands/projects.js'
-import { environmentsCommand } from './commands/environments.js'
-import { configCommand } from './commands/config.js'
-import { envCommand } from './commands/env.js'
-import { updateCommand } from './commands/update.js'
-import { deleteCommand } from './commands/delete.js'
-import { destinationsCommand } from './commands/destinations.js'
-import { showCommand } from './commands/show.js'
-import { deploymentsCommand } from './commands/deployments.js'
-
-const program = new Command()
-
-program
-  .name('coolify-mcp')
-  .description('CLI for Coolify deployment management')
-  .version('0.1.0')
+import { Command } from "commander";
+import chalk from "chalk";
+import { createCommand } from "./commands/create.js";
+import { deployCommand } from "./commands/deploy.js";
+import { listCommand } from "./commands/list.js";
+import { logsCommand } from "./commands/logs.js";
+import { serversCommand } from "./commands/servers.js";
+import { projectsCommand } from "./commands/projects.js";
+import { environmentsCommand } from "./commands/environments.js";
+import { configCommand } from "./commands/config.js";
+import { envCommand } from "./commands/env.js";
+import { updateCommand } from "./commands/update.js";
+import { deleteCommand } from "./commands/delete.js";
+import { destinationsCommand } from "./commands/destinations.js";
+import { showCommand } from "./commands/show.js";
+import { deploymentsCommand } from "./commands/deployments.js";
+import { startCommand } from "./commands/start.js";
+import { stopCommand } from "./commands/stop.js";
+import { restartCommand } from "./commands/restart.js";
+import { buildLogsCommand } from "./commands/build-logs.js";
+import { serviceLogsCommand } from "./commands/service-logs.js";
+import { versionCommand } from "./commands/version.js";
+import { databasesCommand } from "./commands/databases.js";
+import { servicesCommand as servicesListCommand } from "./commands/services.js";
+import { cancelDeployCommand } from "./commands/cancel-deploy.js";
+import { serverResourcesCommand } from "./commands/server-resources.js";
+import {
+  dbListCommand,
+  dbGetCommand,
+  dbStartCommand,
+  dbStopCommand,
+  dbRestartCommand,
+  dbDeleteCommand,
+} from "./commands/db.js";
+import {
+  svcListCommand,
+  svcGetCommand,
+  svcStartCommand,
+  svcStopCommand,
+  svcRestartCommand,
+  svcDeleteCommand,
+} from "./commands/svc.js";
+import {
+  keysListCommand,
+  keysGetCommand,
+  keysDeleteCommand,
+} from "./commands/keys.js";
+import {
+  teamsListCommand,
+  teamsCurrentCommand,
+  teamsMembersCommand,
+} from "./commands/teams.js";
+import {
+  diagnoseAppCommand,
+  diagnoseServerCommand,
+  scanIssuesCommand,
+} from "./commands/diagnose.js";
+import { execCommand } from "./commands/exec.js";
+import { activeDeploymentsCommand } from "./commands/active-deployments.js";
+import {
+  networkInspectCommand,
+  analyzeDeployCommand,
+} from "./commands/network.js";
+
+const program = new Command();
+
+program
+  .name("coolify-mcp")
+  .description("CLI for Coolify deployment management")
+  .version("0.1.0");
 
 // Create application
 program
-  .command('create')
-  .description('Create a new application')
-  .option('--name <name>', 'Application name')
-  .option('--description <desc>', 'Application description')
-  .option('--server <uuid>', 'Server UUID')
-  .option('--project <uuid>', 'Project UUID')
-  .option('--environment <uuid>', 'Environment UUID (auto-fetched if not provided)')
-  .option('--repo <url>', 'Git repository URL')
-  .option('--branch <branch>', 'Git branch', 'main')
-  .option('--type <type>', 'Application type (public, private-github-app, private-deploy-key, dockerfile, docker-image, docker-compose)', 'public')
-  .option('--build-pack <pack>', 'Build pack (dockerfile, nixpacks, static, dockercompose)', 'dockerfile')
-  .option('--ports <ports>', 'Ports to expose (default: 3000)', '3000')
-  .option('--docker-image <image>', 'Docker image (for docker-image type)')
-  .option('--docker-compose <content>', 'Docker Compose content (for docker-compose type)')
-  .option('--docker-compose-location <path>', 'Docker Compose file path (for dockercompose buildPack, e.g., "docker-compose.yml")')
-  .option('--dockerfile-location <path>', 'Dockerfile location (e.g., "apps/haidodocs/Dockerfile")')
-  .option('--base-directory <dir>', 'Base directory for build context (default: "/")', '/')
-  .action(createCommand)
+  .command("create")
+  .description("Create a new application")
+  .option("--name <name>", "Application name")
+  .option("--description <desc>", "Application description")
+  .option("--server <uuid>", "Server UUID")
+  .option("--project <uuid>", "Project UUID")
+  .option(
+    "--environment <uuid>",
+    "Environment UUID (auto-fetched if not provided)",
+  )
+  .option("--repo <url>", "Git repository URL")
+  .option("--branch <branch>", "Git branch", "main")
+  .option(
+    "--type <type>",
+    "Application type (public, private-github-app, private-deploy-key, dockerfile, docker-image, docker-compose)",
+    "public",
+  )
+  .option(
+    "--build-pack <pack>",
+    "Build pack (dockerfile, nixpacks, static, dockercompose)",
+    "dockerfile",
+  )
+  .option("--ports <ports>", "Ports to expose (default: 3000)", "3000")
+  .option("--docker-image <image>", "Docker image (for docker-image type)")
+  .option(
+    "--docker-compose <content>",
+    "Docker Compose content (for docker-compose type)",
+  )
+  .option(
+    "--docker-compose-location <path>",
+    'Docker Compose file path (for dockercompose buildPack, e.g., "docker-compose.yml")',
+  )
+  .option(
+    "--dockerfile-location <path>",
+    'Dockerfile location (e.g., "apps/haidodocs/Dockerfile")',
+  )
+  .option(
+    "--base-directory <dir>",
+    'Base directory for build context (default: "/")',
+    "/",
+  )
+  .action(createCommand);
 
 // Config command
 program
-  .command('config')
-  .description('Manage configuration')
-  .argument('[action]', 'Action to perform (set, get, path)')
-  .option('--key <key>', 'Configuration key (for "set" action)')
-  .option('--value <value>', 'Configuration value (for "set" action)')
-  .action(configCommand)
+  .command("config")
+  .description("Manage configuration")
+  .argument("[action]", "Action to perform (set, get, path)")
+  .option("--key <key>", 'Configuration key (for "set" action)')
+  .option("--value <value>", 'Configuration value (for "set" action)')
+  .action(configCommand);
 
 // List applications
 program
-  .command('list')
-  .description('List all applications')
-  .option('-t, --team <id>', 'Filter by team ID')
-  .option('-p, --project <id>', 'Filter by project ID')
-  .option('--full', 'Show full UUIDs instead of truncated')
-  .action(listCommand)
+  .command("list")
+  .description("List all applications")
+  .option("-t, --team <id>", "Filter by team ID")
+  .option("-p, --project <id>", "Filter by project ID")
+
+  .action(listCommand);
 
 // Deploy application
 program
-  .command('deploy <uuid>')
-  .description('Deploy an application')
-  .option('-f, --force', 'Force rebuild without cache')
-  .option('-t, --tag <tag>', 'Deploy specific tag/version')
-  .action(deployCommand)
+  .command("deploy [uuid]")
+  .description("Deploy an application (reads .coolify.json if no UUID)")
+  .option("-f, --force", "Force rebuild without cache")
+  .option("-t, --tag <tag>", "Deploy specific tag/version")
+  .action(deployCommand);
 
 // Logs command
 program
-  .command('logs <uuid>')
-  .description('Get application logs')
-  .option('-n, --lines <number>', 'Number of lines to retrieve', '50')
-  .option('-f, --follow', 'Follow logs in real-time')
+  .command("logs [uuid]")
+  .description("Get application logs (reads .coolify.json if no UUID)")
+  .option("-n, --lines <number>", "Number of lines to retrieve", "50")
+  .option("-f, --follow", "Follow logs in real-time")
   .action((uuid, options) => {
-    const lines = parseInt(options.lines, 10)
-    logsCommand(uuid, { lines, follow: options.follow })
-  })
+    const lines = parseInt(options.lines, 10);
+    logsCommand(uuid, { lines, follow: options.follow });
+  });
 
 // Servers command
 program
-  .command('servers')
-  .description('List available servers')
-  .option('--full', 'Show full UUIDs instead of truncated')
-  .action((options) => serversCommand(options))
+  .command("servers")
+  .description("List available servers")
+
+  .action((options) => serversCommand(options));
 
 // Projects command
 program
-  .command('projects')
-  .description('List or create projects')
-  .option('--full', 'Show full UUIDs instead of truncated')
-  .option('--create <name>', 'Create a new project with this name')
-  .option('--description <desc>', 'Project description (use with --create)')
-  .action((options) => projectsCommand(options))
+  .command("projects")
+  .description("List or create projects")
+
+  .option("--create <name>", "Create a new project with this name")
+  .option("--description <desc>", "Project description (use with --create)")
+  .action((options) => projectsCommand(options));
 
 // Environments command
 program
-  .command('environments <projectUuid>')
-  .description('List environments for a project')
-  .option('--full', 'Show full UUIDs instead of truncated')
-  .action((projectUuid, options) => environmentsCommand(projectUuid, options))
+  .command("environments <projectUuid>")
+  .description("List environments for a project")
+
+  .action((projectUuid, options) => environmentsCommand(projectUuid, options));
 
 // Env vars command
 program
-  .command('env <uuid>')
-  .description('Manage environment variables for an application')
-  .option('--set <KEY=VALUE>', 'Set an environment variable')
-  .option('--delete <KEY>', 'Delete an environment variable')
-  .option('--buildtime', 'Mark variable as build-time only (use with --set)')
-  .action((uuid, options) => envCommand(uuid, options))
+  .command("env [uuid]")
+  .description("Manage env vars (reads .coolify.json if no UUID)")
+  .option("--set <KEY=VALUE>", "Set an environment variable")
+  .option("--delete <KEY>", "Delete an environment variable")
+  .option("--buildtime", "Mark variable as build-time only (use with --set)")
+  .action((uuid, options) => envCommand(uuid, options));
 
 // Update application
 program
-  .command('update <uuid>')
-  .description('Update an application configuration')
-  .option('--name <name>', 'Application name')
-  .option('--description <desc>', 'Application description')
-  .option('--build-pack <pack>', 'Build pack (dockerfile, nixpacks, static)')
-  .option('--git-branch <branch>', 'Git branch')
-  .option('--ports <ports>', 'Ports to expose (e.g., 3000)')
-  .option('--install-command <cmd>', 'Install command (nixpacks)')
-  .option('--build-command <cmd>', 'Build command')
-  .option('--start-command <cmd>', 'Start command')
-  .option('--dockerfile-location <path>', 'Dockerfile location (e.g., "apps/haidodocs/Dockerfile")')
-  .option('--base-directory <dir>', 'Base directory for build context (e.g., "/")')
-  .option('--domains <domains>', 'Domains (comma-separated with protocol, e.g., "https://app.example.com")')
-  .option('--auto-deploy', 'Enable auto-deploy on git push')
-  .option('--no-auto-deploy', 'Disable auto-deploy on git push')
-  .option('--force-https', 'Enable forced HTTPS redirect')
-  .action((uuid, options) => updateCommand({ uuid, ...options }))
+  .command("update [uuid]")
+  .description("Update app config (reads .coolify.json if no UUID)")
+  .option("--name <name>", "Application name")
+  .option("--description <desc>", "Application description")
+  .option("--build-pack <pack>", "Build pack (dockerfile, nixpacks, static)")
+  .option("--git-branch <branch>", "Git branch")
+  .option("--ports <ports>", "Ports to expose (e.g., 3000)")
+  .option("--install-command <cmd>", "Install command (nixpacks)")
+  .option("--build-command <cmd>", "Build command")
+  .option("--start-command <cmd>", "Start command")
+  .option(
+    "--dockerfile-location <path>",
+    'Dockerfile location (e.g., "apps/haidodocs/Dockerfile")',
+  )
+  .option(
+    "--base-directory <dir>",
+    'Base directory for build context (e.g., "/")',
+  )
+  .option(
+    "--domains <domains>",
+    'Domains (comma-separated with protocol, e.g., "https://app.example.com")',
+  )
+  .option("--auto-deploy", "Enable auto-deploy on git push")
+  .option("--no-auto-deploy", "Disable auto-deploy on git push")
+  .option("--force-https", "Enable forced HTTPS redirect")
+  .action((uuid, options) => updateCommand({ uuid, ...options }));
 
 // Delete application
 program
-  .command('delete <uuid>')
-  .description('Delete an application')
-  .option('-f, --force', 'Skip confirmation prompt')
-  .option('-y, --yes', 'Skip confirmation prompt (alias for --force)')
-  .action((uuid, options) => deleteCommand(uuid, options))
+  .command("delete [uuid]")
+  .description("Delete application (reads .coolify.json if no UUID)")
+  .option("-f, --force", "Skip confirmation prompt")
+  .option("-y, --yes", "Skip confirmation prompt (alias for --force)")
+  .action((uuid, options) => deleteCommand(uuid, options));
 
 // Destinations command
 program
-  .command('destinations <serverUuid>')
-  .description('List available destinations for a server')
-  .action(destinationsCommand)
+  .command("destinations <serverUuid>")
+  .description("List available destinations for a server")
+  .action(destinationsCommand);
 
 // Show application details
 program
-  .command('show <uuid>')
-  .description('Show detailed information about an application')
-  .action(showCommand)
+  .command("show [uuid]")
+  .description("Show app details (reads .coolify.json if no UUID)")
+  .action(showCommand);
 
 // Deployments history
 program
-  .command('deployments <uuid>')
-  .description('Show deployment history for an application')
-  .option('--full', 'Show full UUIDs')
-  .option('-n, --limit <number>', 'Limit number of deployments shown', '10')
+  .command("deployments [uuid]")
+  .description("Show deployment history (reads .coolify.json if no UUID)")
+
+  .option("-n, --limit <number>", "Limit number of deployments shown", "10")
   .action((uuid, options) => {
-    const limit = parseInt(options.limit, 10)
-    deploymentsCommand(uuid, { full: options.full, limit })
-  })
+    const limit = parseInt(options.limit, 10);
+    deploymentsCommand(uuid, { full: options.full, limit });
+  });
+
+// Start application
+program
+  .command("start [uuid]")
+  .description("Start application (reads .coolify.json if no UUID)")
+  .action(startCommand);
+
+// Stop application
+program
+  .command("stop [uuid]")
+  .description("Stop application (reads .coolify.json if no UUID)")
+  .action(stopCommand);
+
+// Restart application
+program
+  .command("restart [uuid]")
+  .description("Restart application (reads .coolify.json if no UUID)")
+  .action(restartCommand);
+
+// Build/deployment logs
+program
+  .command("build-logs <deployment-uuid>")
+  .description("View build/deployment logs for a specific deployment")
+  .option("-n, --lines <number>", "Number of lines to show (tail)")
+  .action((deploymentUuid, options) => {
+    const lines = options.lines ? parseInt(options.lines, 10) : undefined;
+    buildLogsCommand(deploymentUuid, { lines });
+  });
+
+// Service logs (docker-compose)
+program
+  .command("service-logs <uuid> <service-name>")
+  .description("View logs for a specific docker-compose service")
+  .option("-n, --lines <number>", "Number of lines to retrieve", "50")
+  .action((uuid, serviceName, options) => {
+    const lines = parseInt(options.lines, 10);
+    serviceLogsCommand(uuid, serviceName, { lines });
+  });
+
+// Coolify server version
+program
+  .command("version")
+  .description("Show Coolify server version")
+  .action(versionCommand);
+
+// List databases
+program
+  .command("databases")
+  .description("List all databases")
+
+  .action((options) => databasesCommand(options));
+
+// List services
+program
+  .command("services")
+  .description("List all services")
+
+  .action((options) => servicesListCommand(options));
+
+// Cancel deployment
+program
+  .command("cancel-deploy <deployment-uuid>")
+  .description("Cancel an in-progress deployment")
+  .action(cancelDeployCommand);
+
+// Server resources
+program
+  .command("server-resources <server-uuid>")
+  .description("List resources deployed on a server")
+
+  .action((serverUuid, options) => serverResourcesCommand(serverUuid, options));
+
+// ─── Database subcommands ────────────────────────────────────────────────────
+
+const db = program.command("db").description("Manage databases");
+db.command("list").description("List all databases").action(dbListCommand);
+db.command("get <uuid>")
+  .description("Get database details")
+  .action(dbGetCommand);
+db.command("start <uuid>")
+  .description("Start a database")
+  .action(dbStartCommand);
+db.command("stop <uuid>").description("Stop a database").action(dbStopCommand);
+db.command("restart <uuid>")
+  .description("Restart a database")
+  .action(dbRestartCommand);
+db.command("delete <uuid>")
+  .description("Delete a database")
+  .action(dbDeleteCommand);
+db.action(() => db.help());
+
+// ─── Service subcommands ─────────────────────────────────────────────────────
+
+const svc = program.command("svc").description("Manage services");
+svc.command("list").description("List all services").action(svcListCommand);
+svc
+  .command("get <uuid>")
+  .description("Get service details")
+  .action(svcGetCommand);
+svc
+  .command("start <uuid>")
+  .description("Start a service")
+  .action(svcStartCommand);
+svc.command("stop <uuid>").description("Stop a service").action(svcStopCommand);
+svc
+  .command("restart <uuid>")
+  .description("Restart a service")
+  .action(svcRestartCommand);
+svc
+  .command("delete <uuid>")
+  .description("Delete a service")
+  .action(svcDeleteCommand);
+svc.action(() => svc.help());
+
+// ─── SSH Key subcommands ─────────────────────────────────────────────────────
+
+const keys = program.command("keys").description("Manage SSH private keys");
+keys
+  .command("list")
+  .description("List all private keys")
+  .action(keysListCommand);
+keys
+  .command("get <uuid>")
+  .description("Get private key details")
+  .action(keysGetCommand);
+keys
+  .command("delete <uuid>")
+  .description("Delete a private key")
+  .action(keysDeleteCommand);
+keys.action(() => keys.help());
+
+// ─── Team subcommands ────────────────────────────────────────────────────────
+
+const team = program.command("team").description("Manage teams");
+team.command("list").description("List all teams").action(teamsListCommand);
+team
+  .command("current")
+  .description("Show current team")
+  .action(teamsCurrentCommand);
+team
+  .command("members <team-id>")
+  .description("Show team members")
+  .action(teamsMembersCommand);
+team.action(() => team.help());
+
+// ─── Diagnostics ─────────────────────────────────────────────────────────────
+
+program
+  .command("diagnose [query]")
+  .description("Diagnose application (reads .coolify.json if no query)")
+  .action(diagnoseAppCommand);
+
+program
+  .command("diagnose-server <query>")
+  .description("Diagnose a server (name, IP, or UUID)")
+  .action(diagnoseServerCommand);
+
+program
+  .command("scan")
+  .description("Scan all infrastructure for issues")
+  .action(scanIssuesCommand);
+
+// ─── Execute command ─────────────────────────────────────────────────────────
+
+program
+  .command("exec [uuid] <command>")
+  .description("Execute command on app container (reads .coolify.json)")
+  .action(execCommand);
+
+// ─── Active deployments ──────────────────────────────────────────────────────
+
+program
+  .command("active-deployments")
+  .description("List all active/queued deployments")
+  .action(activeDeploymentsCommand);
+
+// ─── Network diagnostics ─────────────────────────────────────────────────────
+
+const net = program.command("network").description("Network diagnostics");
+net
+  .command("inspect [uuid]")
+  .description("Inspect container network (DNS, hosts, connectivity)")
+  .option(
+    "--services <names>",
+    "Comma-separated service names to test (e.g., db,redis)",
+  )
+  .action((uuid, options) => networkInspectCommand(uuid, options));
+net.action(() => net.help());
+
+// ─── Deploy failure analysis ─────────────────────────────────────────────────
+
+program
+  .command("analyze-deploy <deployment-uuid>")
+  .description("Analyze a failed deployment (extract errors, suggest fixes)")
+  .action(analyzeDeployCommand);
 
 // Show help by default
 program.action(() => {
-  console.log(chalk.cyan('Coolify MCP CLI'))
-  console.log(chalk.gray('Manage Coolify deployments from the command line\n'))
-  program.help()
-})
+  console.log(chalk.cyan("Coolify MCP CLI v0.6.0"));
+  console.log(chalk.gray("Manage Coolify deployments from the command line\n"));
+  program.help();
+});
 
-program.parse()
+program.parse();