@mks2508/coolify-mks-cli-mcp 0.8.0 → 0.9.0

package/src/cli/index.ts

@@ -82,6 +82,11 @@ import {
   networkInspectCommand,
   analyzeDeployCommand,
 } from "./commands/network.js";
+import {
+  volumesListCommand,
+  volumesAddCommand,
+  volumesRemoveCommand,
+} from "./commands/volumes.js";
 
 const program = new Command();
 
@@ -94,11 +99,11 @@ program
     `${chalk.bold.hex("#8c52ff")("Coolify CLI")} — Manage deployments, env vars, and resources\n` +
     `  Global: ${chalk.gray("bun install -g @mks2508/coolify-mks-cli-mcp")}`,
   )
-  .version("0.8.0")
+  .version("0.9.0")
   .addHelpText("beforeAll", () => {
     // Show banner before help output
     const { showAutoBanner } = require("./ui/banner.js");
-    showAutoBanner("0.8.0");
+    showAutoBanner("0.9.0");
     return "";
   });
 
@@ -149,6 +154,10 @@ program
     "--github-app-uuid <uuid>",
     "GitHub App UUID (auto-detected if not provided)",
   )
+  .option(
+    "--private-key-uuid <uuid>",
+    "Private key UUID (required for private-deploy-key type)",
+  )
   .option(
     "--domain <domain>",
     "Domain to set after creation (e.g., app.example.com or https://app.example.com)",
@@ -247,14 +256,21 @@ program
 program
   .command("env [uuid]")
   .description("Manage env vars (reads .coolify.json if no UUID)")
-  .option("--set <KEY=VALUE>", "Set an environment variable")
+  .option(
+    "--set <KEY=VALUE>",
+    "Set an environment variable (can be repeated: --set A=1 --set B=2)",
+    (value: string, prev: string[] | undefined) => (prev ?? []).concat(value),
+    [] as string[],
+  )
   .option("--delete <KEY>", "Delete an environment variable")
+  .option("--get <KEY>", "Get a single environment variable value (prints value, no colors)")
   .option("--buildtime", "Mark variable as build-time only (use with --set)")
   .option("--runtime-only", "Mark variable as runtime only, not build-time (use with --set)")
-  .option("--sync [file]", "Sync env vars from .env file (default: .env)")
+  .option("--sync [file]", "Sync env vars from .env file (default: .env, or stdin with -)")
   .option("--dry-run", "Preview changes without applying (use with --sync)")
   .option("--prune", "Delete vars not in file (use with --sync)")
   .option("--table", "Show env vars in table format")
+  .option("--json", "Output machine-parseable JSON (ICoolifyEnvVar[])")
   .action((uuid, options) => envCommand(uuid, options));
 
 // Update application
@@ -283,6 +299,11 @@ program
   )
   .option("--auto-deploy", "Enable auto-deploy on git push")
   .option("--no-auto-deploy", "Disable auto-deploy on git push")
+  .option(
+    "--watch-paths <paths>",
+    'Watch paths for selective auto-deploy (newline-separated globs, e.g. "src/**\\npackages/**")',
+  )
+  .option("--clear-watch-paths", "Clear watch paths (deploy on all changes)")
   .option("--force-https", "Enable forced HTTPS redirect")
   .option("--health-check-enabled", "Enable health check")
   .option("--no-health-check-enabled", "Disable health check")
@@ -553,6 +574,31 @@ program
   .description("Analyze a failed deployment (extract errors, suggest fixes)")
   .action(analyzeDeployCommand);
 
+// ─── Volumes subcommands ──────────────────────────────────────────────────────
+
+const volumes = program.command("volumes").description("Manage volumes for docker-compose apps");
+volumes
+  .command("list <uuid>")
+  .description("List volumes for an application")
+  .option("--service <name>", "Service name (for multi-service compose)")
+  .action((uuid, options) => volumesListCommand(uuid, options));
+volumes
+  .command("add <uuid>")
+  .description("Add a bind mount volume")
+  .requiredOption("--source <path>", "Source path on host")
+  .requiredOption("--target <path>", "Target path in container")
+  .option("--service <name>", "Service name (required for multi-service compose)")
+  .option("--no-restart", "Skip automatic redeploy after adding volume")
+  .action((uuid, options) => volumesAddCommand(uuid, options));
+volumes
+  .command("remove <uuid>")
+  .description("Remove a volume by target path")
+  .requiredOption("--target <path>", "Target path in container to remove")
+  .option("--service <name>", "Service name (required for multi-service compose)")
+  .option("--no-restart", "Skip automatic redeploy after removing volume")
+  .action((uuid, options) => volumesRemoveCommand(uuid, options));
+volumes.action(() => volumes.help());
+
 // Show help by default (or interactive menu if no args)
 program.action(async () => {
   // If called without arguments, show interactive menu

package/src/cli/ui/banner.ts

@@ -203,7 +203,7 @@ export function getMiniLogoLines(): string[] {
  * @param subtitle - Optional subtitle line
  */
 export function showBanner(
-  version: string = "0.8.0",
+  version: string = "0.9.0",
   subtitle?: string,
 ): void {
   const logoLines = renderLogo();
@@ -244,7 +244,7 @@ export function showBanner(
  *
  * @param version - CLI version string
  */
-export function showCompactBanner(version: string = "0.8.0"): void {
+export function showCompactBanner(version: string = "0.9.0"): void {
   console.log(
     `${chalk.hex("#8c52ff")("█")} ${chalk.bold("Coolify CLI")} ${chalk.gray(`v${version}`)}`,
   );
@@ -257,7 +257,7 @@ export function showCompactBanner(version: string = "0.8.0"): void {
  * @param subtitle - Optional subtitle for full banner
  */
 export function showAutoBanner(
-  version: string = "0.8.0",
+  version: string = "0.9.0",
   subtitle?: string,
 ): void {
   if (process.stdout.isTTY) {

package/src/cli/ui/screen.ts

@@ -12,7 +12,7 @@ import type {
   ICoolifyApplication,
   ICoolifyResource,
 } from "../../coolify/types.js";
-import { loadConfig } from "../../coolify/config.js";
+import { loadConfig, getCachedAppSettings } from "../../coolify/config.js";
 import { getMiniLogoLines } from "./banner.js";
 
 // ─── ANSI ────────────────────────────────────────────────────────────────────
@@ -147,7 +147,7 @@ function renderHeader(tree: ICoolifyInfrastructureTree): void {
 
   const textLines = [
     "",
-    `${chalk.bold.hex("#a875ff")("Coolify CLI")} ${chalk.hex("#777777")("v0.8.0")}`,
+    `${chalk.bold.hex("#a875ff")("Coolify CLI")} ${chalk.hex("#777777")("v0.9.0")}`,
     "",
     `${chalk.hex("#cccccc")(serverDisplay)}`,
     "",
@@ -400,6 +400,25 @@ function buildDetailPanel(
     );
   }
 
+  // Deploy settings (auto-deploy from API settings or local cache, watch_paths from API)
+  lines.push("");
+  const autoDeployFromApi = app.settings?.is_auto_deploy_enabled;
+  // getCachedAppSettings is async but we need sync here — use a pre-fetched value
+  // passed via the context, or show API value / fallback
+  if (autoDeployFromApi !== undefined) {
+    lines.push(
+      `${chalk.hex("#888888")("Auto-deploy:")} ${autoDeployFromApi ? chalk.green("ON") : chalk.red("OFF")}`,
+    );
+  }
+  if (app.watch_paths) {
+    const paths = app.watch_paths.split("\n").filter(Boolean);
+    lines.push(`${chalk.hex("#888888")("Watch:")} ${chalk.hex("#cccccc")(paths[0])}`);
+    for (const p of paths.slice(1, 3)) {
+      lines.push(`       ${chalk.hex("#cccccc")(p)}`);
+    }
+    if (paths.length > 3) lines.push(chalk.hex("#555555")(`       +${paths.length - 3} more`));
+  }
+
   if (app.install_command || app.build_command || app.start_command) {
     lines.push("");
     if (app.install_command) lines.push(`${chalk.hex("#888888")("Install:")} ${chalk.hex("#aaaaaa")(app.install_command.slice(0, rightW - 10))}`);
@@ -564,6 +583,11 @@ export function buildResourcePreview(app: ICoolifyApplication): string[] {
   for (const [label, value] of fields) {
     if (value) lines.push(`${chalk.hex("#888888")(label + ":")} ${chalk.hex("#cccccc")(value)}`);
   }
+  if (app.watch_paths) {
+    const paths = app.watch_paths.split("\n").filter(Boolean);
+    lines.push(`${chalk.hex("#888888")("Watch:")} ${chalk.hex("#cccccc")(paths[0])}`);
+    if (paths.length > 1) lines.push(chalk.hex("#555555")(`  +${paths.length - 1} more`));
+  }
   if (app.destination?.server) {
     lines.push("");
     lines.push(`${chalk.hex("#888888")("Server:")} ${chalk.hex("#cccccc")(app.destination.server.name)}`);

package/src/coolify/config.ts

@@ -112,4 +112,79 @@ export async function getCoolifyToken(): Promise<string | undefined> {
   return process.env.COOLIFY_TOKEN;
 }
 
+// ─── App Settings Cache ──────────────────────────────────────────────────────
+// Coolify API GET does not return application_settings (is_auto_deploy_enabled,
+// is_force_https_enabled, etc). We cache these locally when the user sets them
+// via our CLI so we can display them later in `show`.
+
+const SETTINGS_CACHE_FILE = join(CONFIG_DIR, "app-settings-cache.json");
+
+/**
+ * Cached application settings that the Coolify API doesn't expose in GET responses.
+ */
+export interface ICachedAppSettings {
+  /** Auto-deploy on git push */
+  isAutoDeployEnabled?: boolean;
+  /** Watch paths for selective deploy */
+  watchPaths?: string | null;
+  /** When this cache entry was last updated */
+  cachedAt?: string;
+}
+
+/**
+ * Reads the full settings cache from disk.
+ *
+ * @returns Map of appUuid → cached settings
+ */
+async function readSettingsCache(): Promise<Record<string, ICachedAppSettings>> {
+  try {
+    if (existsSync(SETTINGS_CACHE_FILE)) {
+      const content = await readFile(SETTINGS_CACHE_FILE, "utf-8");
+      return JSON.parse(content);
+    }
+  } catch {
+    // Corrupted file — start fresh
+  }
+  return {};
+}
+
+/**
+ * Caches application settings locally after a successful PATCH.
+ *
+ * @param appUuid - Application UUID
+ * @param settings - Settings to cache (merged with existing)
+ */
+export async function cacheAppSettings(
+  appUuid: string,
+  settings: Partial<ICachedAppSettings>,
+): Promise<void> {
+  try {
+    const cache = await readSettingsCache();
+    cache[appUuid] = {
+      ...cache[appUuid],
+      ...settings,
+      cachedAt: new Date().toISOString(),
+    };
+    if (!existsSync(CONFIG_DIR)) {
+      await mkdir(CONFIG_DIR, { recursive: true });
+    }
+    await writeFile(SETTINGS_CACHE_FILE, JSON.stringify(cache, null, 2));
+  } catch {
+    // Non-critical — silently ignore cache write failures
+  }
+}
+
+/**
+ * Reads cached settings for an application.
+ *
+ * @param appUuid - Application UUID
+ * @returns Cached settings or null if not cached
+ */
+export async function getCachedAppSettings(
+  appUuid: string,
+): Promise<ICachedAppSettings | null> {
+  const cache = await readSettingsCache();
+  return cache[appUuid] || null;
+}
+
 export { CONFIG_DIR, CONFIG_FILE };