@tarout/cli 0.1.4 → 0.2.0

package/dist/chunk-VO4OYJW3.js

@@ -0,0 +1,53 @@
+// src/utils/prompts.ts
+import inquirer from "inquirer";
+async function confirm(message, defaultValue = false) {
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: "confirm",
+      name: "confirmed",
+      message,
+      default: defaultValue
+    }
+  ]);
+  return confirmed;
+}
+async function input(message, defaultValue) {
+  const { value } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "value",
+      message,
+      default: defaultValue
+    }
+  ]);
+  return value;
+}
+async function select(message, choices) {
+  const { value } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "value",
+      message,
+      choices
+    }
+  ]);
+  return value;
+}
+async function password(message) {
+  const { value } = await inquirer.prompt([
+    {
+      type: "password",
+      name: "value",
+      message,
+      mask: "*"
+    }
+  ]);
+  return value;
+}
+
+export {
+  confirm,
+  input,
+  select,
+  password
+};

package/dist/index.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
+import {
+  confirm,
+  input,
+  select
+} from "./chunk-VO4OYJW3.js";
 import {
   failSpinner,
   startSpinner,
@@ -19,6 +24,14 @@ import superjson from "superjson";
 
 // src/lib/config.ts
 import Conf from "conf";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { join } from "path";
 var config = new Conf({
   projectName: "tarout",
   defaults: {
@@ -65,6 +78,58 @@ function updateProfile(updates) {
     });
   }
 }
+var PROJECT_CONFIG_DIR = ".tarout";
+var PROJECT_CONFIG_FILE = "project.json";
+function getProjectConfigDir(basePath) {
+  const base = basePath || process.cwd();
+  return join(base, PROJECT_CONFIG_DIR);
+}
+function getProjectConfigPath(basePath) {
+  return join(getProjectConfigDir(basePath), PROJECT_CONFIG_FILE);
+}
+function isProjectLinked(basePath) {
+  return existsSync(getProjectConfigPath(basePath));
+}
+function getProjectConfig(basePath) {
+  const configPath = getProjectConfigPath(basePath);
+  if (!existsSync(configPath)) {
+    return null;
+  }
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function setProjectConfig(config2, basePath) {
+  const configDir = getProjectConfigDir(basePath);
+  const configPath = getProjectConfigPath(basePath);
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+  writeFileSync(configPath, JSON.stringify(config2, null, 2), "utf-8");
+  const gitignorePath = join(configDir, ".gitignore");
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(
+      gitignorePath,
+      "# Ignore local tarout config\n*\n!.gitignore\n",
+      "utf-8"
+    );
+  }
+}
+function removeProjectConfig(basePath) {
+  const configDir = getProjectConfigDir(basePath);
+  if (!existsSync(configDir)) {
+    return false;
+  }
+  try {
+    rmSync(configDir, { recursive: true, force: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // src/utils/exit-codes.ts
 var ExitCode = {
@@ -651,42 +716,6 @@ function getApiClient() {
   return client;
 }
 
-// src/utils/prompts.ts
-import inquirer from "inquirer";
-async function confirm(message, defaultValue = false) {
-  const { confirmed } = await inquirer.prompt([
-    {
-      type: "confirm",
-      name: "confirmed",
-      message,
-      default: defaultValue
-    }
-  ]);
-  return confirmed;
-}
-async function input(message, defaultValue) {
-  const { value } = await inquirer.prompt([
-    {
-      type: "input",
-      name: "value",
-      message,
-      default: defaultValue
-    }
-  ]);
-  return value;
-}
-async function select(message, choices) {
-  const { value } = await inquirer.prompt([
-    {
-      type: "list",
-      name: "value",
-      message,
-      choices
-    }
-  ]);
-  return value;
-}
-
 // src/commands/apps.ts
 function registerAppsCommands(program2) {
   const apps = program2.command("apps").description("Manage applications");
@@ -1219,8 +1248,424 @@ function registerAuthCommands(program2) {
   });
 }
 
-// src/commands/db.ts
+// src/lib/process.ts
 import { spawn } from "child_process";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+function readPackageJson(basePath) {
+  const base = basePath || process.cwd();
+  const packagePath = join2(base, "package.json");
+  if (!existsSync2(packagePath)) {
+    return null;
+  }
+  try {
+    const content = readFileSync2(packagePath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function detectPackageManager(basePath) {
+  const base = basePath || process.cwd();
+  if (existsSync2(join2(base, "bun.lockb")) || existsSync2(join2(base, "bun.lock"))) {
+    return "bun";
+  }
+  if (existsSync2(join2(base, "pnpm-lock.yaml"))) {
+    return "pnpm";
+  }
+  if (existsSync2(join2(base, "yarn.lock"))) {
+    return "yarn";
+  }
+  if (existsSync2(join2(base, "package-lock.json"))) {
+    return "npm";
+  }
+  const pkg = readPackageJson(basePath);
+  if (pkg?.packageManager) {
+    if (pkg.packageManager.startsWith("bun")) return "bun";
+    if (pkg.packageManager.startsWith("pnpm")) return "pnpm";
+    if (pkg.packageManager.startsWith("yarn")) return "yarn";
+    if (pkg.packageManager.startsWith("npm")) return "npm";
+  }
+  return "npm";
+}
+var FRAMEWORKS = [
+  {
+    dependencies: ["next"],
+    info: {
+      name: "Next.js",
+      devCommand: "next dev",
+      buildCommand: "next build",
+      defaultPort: 3e3
+    }
+  },
+  {
+    dependencies: ["vite"],
+    info: {
+      name: "Vite",
+      devCommand: "vite",
+      buildCommand: "vite build",
+      defaultPort: 5173
+    }
+  },
+  {
+    dependencies: ["@remix-run/dev"],
+    info: {
+      name: "Remix",
+      devCommand: "remix dev",
+      buildCommand: "remix build",
+      defaultPort: 3e3
+    }
+  },
+  {
+    dependencies: ["nuxt"],
+    info: {
+      name: "Nuxt",
+      devCommand: "nuxt dev",
+      buildCommand: "nuxt build",
+      defaultPort: 3e3
+    }
+  },
+  {
+    dependencies: ["astro"],
+    info: {
+      name: "Astro",
+      devCommand: "astro dev",
+      buildCommand: "astro build",
+      defaultPort: 4321
+    }
+  },
+  {
+    dependencies: ["@angular/core"],
+    info: {
+      name: "Angular",
+      devCommand: "ng serve",
+      buildCommand: "ng build",
+      defaultPort: 4200
+    }
+  },
+  {
+    dependencies: ["svelte-kit", "@sveltejs/kit"],
+    info: {
+      name: "SvelteKit",
+      devCommand: "svelte-kit dev",
+      buildCommand: "svelte-kit build",
+      defaultPort: 5173
+    }
+  },
+  {
+    dependencies: ["svelte"],
+    info: {
+      name: "Svelte",
+      devCommand: "vite",
+      buildCommand: "vite build",
+      defaultPort: 5173
+    }
+  },
+  {
+    dependencies: ["react-scripts"],
+    info: {
+      name: "Create React App",
+      devCommand: "react-scripts start",
+      buildCommand: "react-scripts build",
+      defaultPort: 3e3
+    }
+  },
+  {
+    dependencies: ["gatsby"],
+    info: {
+      name: "Gatsby",
+      devCommand: "gatsby develop",
+      buildCommand: "gatsby build",
+      defaultPort: 8e3
+    }
+  },
+  {
+    dependencies: ["express"],
+    info: {
+      name: "Express",
+      devCommand: "node",
+      buildCommand: "echo 'No build required'",
+      defaultPort: 3e3
+    }
+  }
+];
+function detectFramework(pkg) {
+  const allDeps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies
+  };
+  for (const framework of FRAMEWORKS) {
+    for (const dep of framework.dependencies) {
+      if (dep in allDeps) {
+        return framework.info;
+      }
+    }
+  }
+  return null;
+}
+function getDevCommand(pkg, pm) {
+  const devScripts = ["dev", "start:dev", "serve", "start"];
+  for (const script of devScripts) {
+    if (pkg.scripts?.[script]) {
+      return `${pm} run ${script}`;
+    }
+  }
+  const framework = detectFramework(pkg);
+  if (framework) {
+    return `${pm === "npm" ? "npx" : pm} ${framework.devCommand}`;
+  }
+  return `${pm} run dev`;
+}
+function getBuildCommand(pkg, pm) {
+  if (pkg.scripts?.build) {
+    return `${pm} run build`;
+  }
+  const framework = detectFramework(pkg);
+  if (framework) {
+    return `${pm === "npm" ? "npx" : pm} ${framework.buildCommand}`;
+  }
+  return `${pm} run build`;
+}
+function getDefaultPort(pkg) {
+  const framework = detectFramework(pkg);
+  return framework?.defaultPort || 3e3;
+}
+function runCommand(command, env, options = {}) {
+  return new Promise((resolve) => {
+    const [cmd, ...args] = parseCommand(command);
+    const spawnOptions = {
+      cwd: options.cwd || process.cwd(),
+      env: {
+        ...process.env,
+        ...env
+      },
+      stdio: ["inherit", "pipe", "pipe"],
+      shell: true
+    };
+    const child = spawn(cmd, args, spawnOptions);
+    child.stdout?.on("data", (data) => {
+      const str = data.toString();
+      if (options.onStdout) {
+        options.onStdout(str);
+      } else {
+        process.stdout.write(str);
+      }
+    });
+    child.stderr?.on("data", (data) => {
+      const str = data.toString();
+      if (options.onStderr) {
+        options.onStderr(str);
+      } else {
+        process.stderr.write(str);
+      }
+    });
+    const handleSignal = () => {
+      child.kill("SIGINT");
+    };
+    process.on("SIGINT", handleSignal);
+    process.on("SIGTERM", handleSignal);
+    child.on("close", (code, signal) => {
+      process.off("SIGINT", handleSignal);
+      process.off("SIGTERM", handleSignal);
+      resolve({
+        exitCode: code ?? 1,
+        signal
+      });
+    });
+    child.on("error", (err) => {
+      process.off("SIGINT", handleSignal);
+      process.off("SIGTERM", handleSignal);
+      console.error(`Failed to start process: ${err.message}`);
+      resolve({
+        exitCode: 1,
+        signal: null
+      });
+    });
+  });
+}
+function parseCommand(command) {
+  const parts = [];
+  let current = "";
+  let inQuote = false;
+  let quoteChar = "";
+  for (const char of command) {
+    if ((char === '"' || char === "'") && !inQuote) {
+      inQuote = true;
+      quoteChar = char;
+    } else if (char === quoteChar && inQuote) {
+      inQuote = false;
+      quoteChar = "";
+    } else if (char === " " && !inQuote) {
+      if (current) {
+        parts.push(current);
+        current = "";
+      }
+    } else {
+      current += char;
+    }
+  }
+  if (current) {
+    parts.push(current);
+  }
+  return parts;
+}
+function envVarsToObject(variables) {
+  const result = {};
+  for (const v of variables) {
+    if (v.value !== null) {
+      result[v.key] = v.value;
+    }
+  }
+  return result;
+}
+
+// src/commands/build.ts
+function registerBuildCommand(program2) {
+  program2.command("build").description("Build locally with cloud environment variables").option("-a, --app <app>", "Application ID or name (overrides linked app)").option("-c, --command <command>", "Custom build command to run").action(async (options) => {
+    try {
+      if (!isLoggedIn()) throw new AuthError();
+      const profile = getCurrentProfile();
+      if (!profile) throw new AuthError();
+      const client2 = getApiClient();
+      let applicationId;
+      let appName;
+      if (options.app) {
+        const _spinner = startSpinner("Finding application...");
+        const apps = await client2.application.allByOrganization.query();
+        const app = findApp2(apps, options.app);
+        if (!app) {
+          failSpinner();
+          const suggestions = findSimilar(
+            options.app,
+            apps.map((a) => a.name)
+          );
+          throw new NotFoundError("Application", options.app, suggestions);
+        }
+        applicationId = app.applicationId;
+        appName = app.name;
+        succeedSpinner();
+      } else if (isProjectLinked()) {
+        const config2 = getProjectConfig();
+        if (!config2) {
+          throw new CliError(
+            "Project config is corrupted. Run 'tarout link' to relink."
+          );
+        }
+        applicationId = config2.applicationId;
+        appName = config2.name;
+      } else {
+        throw new InvalidArgumentError(
+          "No linked application. Run 'tarout link' first or use --app flag."
+        );
+      }
+      const pkg = readPackageJson();
+      if (!pkg) {
+        throw new CliError(
+          "No package.json found in current directory. Make sure you're in a Node.js project."
+        );
+      }
+      const pm = detectPackageManager();
+      let buildCommand = options.command;
+      if (!buildCommand) {
+        buildCommand = getBuildCommand(pkg, pm);
+      }
+      const _envSpinner = startSpinner(
+        `Fetching environment variables for ${appName}...`
+      );
+      let envVars = {};
+      try {
+        const variables = await client2.envVariable.list.query({
+          applicationId,
+          includeValues: true
+        });
+        envVars = envVarsToObject(variables);
+        succeedSpinner(
+          `Loaded ${Object.keys(envVars).length} environment variables`
+        );
+      } catch (err) {
+        failSpinner();
+        throw new CliError(
+          `Failed to fetch environment variables: ${err instanceof Error ? err.message : "Unknown error"}`
+        );
+      }
+      envVars.NODE_ENV = envVars.NODE_ENV || "production";
+      const framework = detectFramework(pkg);
+      if (isJsonMode()) {
+        const startTime2 = Date.now();
+        const result2 = await runCommand(buildCommand, envVars);
+        const duration2 = Math.round((Date.now() - startTime2) / 1e3);
+        outputData({
+          success: result2.exitCode === 0,
+          applicationId,
+          appName,
+          command: buildCommand,
+          framework: framework?.name || "Unknown",
+          envVarCount: Object.keys(envVars).length,
+          packageManager: pm,
+          exitCode: result2.exitCode,
+          duration: duration2
+        });
+        if (result2.exitCode !== 0) {
+          process.exit(result2.exitCode);
+        }
+        return;
+      }
+      log("");
+      log(colors.bold(`Building ${colors.cyan(appName)}`));
+      log("");
+      log(`  Framework:       ${colors.dim(framework?.name || "Unknown")}`);
+      log(`  Package Manager: ${colors.dim(pm)}`);
+      log(`  Command:         ${colors.dim(buildCommand)}`);
+      log(
+        `  Env Variables:   ${colors.dim(String(Object.keys(envVars).length))}`
+      );
+      log("");
+      log(colors.dim("\u2500".repeat(50)));
+      log("");
+      const startTime = Date.now();
+      const result = await runCommand(buildCommand, envVars);
+      const duration = Math.round((Date.now() - startTime) / 1e3);
+      log("");
+      log(colors.dim("\u2500".repeat(50)));
+      log("");
+      if (result.exitCode === 0) {
+        log(colors.success(`Build completed successfully in ${duration}s`));
+        log("");
+        log("Next steps:");
+        log(`  ${colors.dim("tarout deploy")}  - Deploy to cloud`);
+        log("");
+      } else {
+        log(
+          colors.error(
+            `Build failed with exit code ${result.exitCode} (${duration}s)`
+          )
+        );
+        log("");
+        log("Troubleshooting:");
+        log(`  ${colors.dim("1.")} Check the build output above for errors`);
+        log(`  ${colors.dim("2.")} Verify all dependencies are installed`);
+        log(
+          `  ${colors.dim("3.")} Make sure environment variables are correct`
+        );
+        log("");
+        throw new BuildFailedError(
+          `Build failed with exit code ${result.exitCode}`
+        );
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+function findApp2(apps, identifier) {
+  const lowerIdentifier = identifier.toLowerCase();
+  return apps.find(
+    (app) => app.applicationId === identifier || app.applicationId.startsWith(identifier) || app.name.toLowerCase() === lowerIdentifier || app.appName?.toLowerCase() === lowerIdentifier
+  );
+}
+
+// src/commands/db.ts
+import { spawn as spawn2 } from "child_process";
 function registerDbCommands(program2) {
   const db = program2.command("db").description("Manage databases");
   db.command("list").alias("ls").description("List all databases").option("-t, --type <type>", "Filter by type (postgres, mysql, redis)").action(async (options) => {
@@ -1561,7 +2006,7 @@ function registerDbCommands(program2) {
       log(`Connecting to ${colors.bold(dbDetails.name)}...`);
       log(colors.dim("Press Ctrl+D to exit"));
       log("");
-      const child = spawn(command, args, {
+      const child = spawn2(command, args, {
         stdio: "inherit",
         env: { ...process.env, ...env }
       });
@@ -1758,7 +2203,7 @@ function registerDeployCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Finding application...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp2(apps, appIdentifier);
+      const app = findApp3(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -1811,7 +2256,7 @@ function registerDeployCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Fetching status...");
       const apps = await client2.application.allByOrganization.query();
-      const appSummary = findApp2(apps, appIdentifier);
+      const appSummary = findApp3(apps, appIdentifier);
       if (!appSummary) {
         failSpinner();
         const suggestions = findSimilar(
@@ -1860,7 +2305,7 @@ function registerDeployCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Cancelling deployment...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp2(apps, appIdentifier);
+      const app = findApp3(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -1886,7 +2331,7 @@ function registerDeployCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Fetching deployments...");
       const apps = await client2.application.allByOrganization.query();
-      const appSummary = findApp2(apps, appIdentifier);
+      const appSummary = findApp3(apps, appIdentifier);
       if (!appSummary) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2064,6 +2509,123 @@ function registerDeployCommands(program2) {
       handleError(err);
     }
   });
+  program2.command("deploy:rollback").argument("<app>", "Application ID or name").description("Rollback to a previous deployment").option("--to <deployment-id>", "Specific deployment ID to rollback to").option("--previous", "Rollback to the immediately previous deployment").option("-w, --wait", "Wait for rollback to complete").action(async (appIdentifier, options) => {
+    try {
+      if (!isLoggedIn()) throw new AuthError();
+      const client2 = getApiClient();
+      const _spinner = startSpinner("Finding application...");
+      const apps = await client2.application.allByOrganization.query();
+      const appSummary = findApp3(apps, appIdentifier);
+      if (!appSummary) {
+        failSpinner();
+        const suggestions = findSimilar(
+          appIdentifier,
+          apps.map((a) => a.name)
+        );
+        throw new NotFoundError("Application", appIdentifier, suggestions);
+      }
+      const deployments = await client2.deployment.all.query({
+        applicationId: appSummary.applicationId
+      });
+      succeedSpinner();
+      const successfulDeployments = deployments.filter(
+        (d) => d.status === "done"
+      );
+      if (successfulDeployments.length === 0) {
+        log("");
+        log("No successful deployments found to rollback to.");
+        return;
+      }
+      let targetDeploymentId;
+      if (options.to) {
+        const targetDeployment = successfulDeployments.find(
+          (d) => d.deploymentId === options.to || d.deploymentId.startsWith(options.to)
+        );
+        if (!targetDeployment) {
+          throw new NotFoundError("Deployment", options.to);
+        }
+        targetDeploymentId = targetDeployment.deploymentId;
+      } else if (options.previous) {
+        if (successfulDeployments.length < 2) {
+          log("");
+          log("No previous deployment to rollback to.");
+          log("There must be at least 2 successful deployments.");
+          return;
+        }
+        targetDeploymentId = successfulDeployments[1].deploymentId;
+      } else {
+        log("");
+        log(
+          `Select a deployment to rollback to for ${colors.cyan(appSummary.name)}:`
+        );
+        log("");
+        const choices = successfulDeployments.slice(0, 10).map((d, index) => ({
+          name: `${colors.cyan(d.deploymentId.slice(0, 8))} - ${d.title || "Deployment"} (${formatDate3(d.createdAt)})${index === 0 ? colors.dim(" [current]") : ""}`,
+          value: d.deploymentId
+        }));
+        const { select: select2 } = await import("./prompts-B53LIJLG.js");
+        targetDeploymentId = await select2("Select deployment:", choices);
+      }
+      if (!options.yes) {
+        const targetDeployment = successfulDeployments.find(
+          (d) => d.deploymentId === targetDeploymentId
+        );
+        log("");
+        log(`Rolling back ${colors.cyan(appSummary.name)} to:`);
+        log(`  Deployment: ${colors.cyan(targetDeploymentId.slice(0, 8))}`);
+        log(`  Title: ${targetDeployment?.title || "Deployment"}`);
+        log(`  Created: ${formatDate3(targetDeployment?.createdAt)}`);
+        log("");
+        const { confirm: confirm2 } = await import("./prompts-B53LIJLG.js");
+        const confirmed = await confirm2(
+          "Are you sure you want to rollback?",
+          false
+        );
+        if (!confirmed) {
+          log("Cancelled.");
+          return;
+        }
+      }
+      const _rollbackSpinner = startSpinner("Initiating rollback...");
+      const result = await client2.deployment.rollback.mutate({
+        applicationId: appSummary.applicationId,
+        targetDeploymentId
+      });
+      if (options.wait) {
+        await streamDeploymentWithLogs(
+          client2,
+          result.deploymentId,
+          appSummary.name,
+          appSummary.applicationId
+        );
+        return;
+      }
+      succeedSpinner("Rollback initiated!");
+      if (isJsonMode()) {
+        outputData({
+          deploymentId: result.deploymentId,
+          rollbackFrom: targetDeploymentId,
+          status: "running"
+        });
+      } else {
+        quietOutput(result.deploymentId);
+        log("");
+        log(`Deployment ID: ${colors.cyan(result.deploymentId)}`);
+        log(`Rolling back to: ${colors.dim(targetDeploymentId.slice(0, 8))}`);
+        log("");
+        log("Rollback is running in the background.");
+        log(
+          `Check status: ${colors.dim(`tarout deploy:status ${appSummary.applicationId.slice(0, 8)}`)}`
+        );
+        log(
+          `View logs: ${colors.dim(`tarout deploy:logs ${result.deploymentId.slice(0, 8)}`)}`
+        );
+        log("");
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
 }
 function registerLogsCommand(program2) {
   program2.command("logs").argument("<app>", "Application ID or name").description("View application logs").option(
@@ -2076,7 +2638,7 @@ function registerLogsCommand(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Fetching logs...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp2(apps, appIdentifier);
+      const app = findApp3(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2149,7 +2711,7 @@ function registerLogsCommand(program2) {
     }
   });
 }
-function findApp2(apps, identifier) {
+function findApp3(apps, identifier) {
   const lowerIdentifier = identifier.toLowerCase();
   return apps.find(
     (app) => app.applicationId === identifier || app.applicationId.startsWith(identifier) || app.name.toLowerCase() === lowerIdentifier || app.appName?.toLowerCase() === lowerIdentifier
@@ -2396,6 +2958,129 @@ function printLogLine(line) {
   }
 }
 
+// src/commands/dev.ts
+function registerDevCommand(program2) {
+  program2.command("dev").description(
+    "Run local development server with cloud environment variables"
+  ).option("-a, --app <app>", "Application ID or name (overrides linked app)").option("-p, --port <port>", "Port to run the dev server on").option("-c, --command <command>", "Custom dev command to run").action(async (options) => {
+    try {
+      if (!isLoggedIn()) throw new AuthError();
+      const profile = getCurrentProfile();
+      if (!profile) throw new AuthError();
+      const client2 = getApiClient();
+      let applicationId;
+      let appName;
+      if (options.app) {
+        const _spinner = startSpinner("Finding application...");
+        const apps = await client2.application.allByOrganization.query();
+        const app = findApp4(apps, options.app);
+        if (!app) {
+          failSpinner();
+          const suggestions = findSimilar(
+            options.app,
+            apps.map((a) => a.name)
+          );
+          throw new NotFoundError("Application", options.app, suggestions);
+        }
+        applicationId = app.applicationId;
+        appName = app.name;
+        succeedSpinner();
+      } else if (isProjectLinked()) {
+        const config2 = getProjectConfig();
+        if (!config2) {
+          throw new CliError(
+            "Project config is corrupted. Run 'tarout link' to relink."
+          );
+        }
+        applicationId = config2.applicationId;
+        appName = config2.name;
+      } else {
+        throw new InvalidArgumentError(
+          "No linked application. Run 'tarout link' first or use --app flag."
+        );
+      }
+      const pkg = readPackageJson();
+      if (!pkg) {
+        throw new CliError(
+          "No package.json found in current directory. Make sure you're in a Node.js project."
+        );
+      }
+      const pm = detectPackageManager();
+      let devCommand = options.command;
+      if (!devCommand) {
+        devCommand = getDevCommand(pkg, pm);
+      }
+      const defaultPort = getDefaultPort(pkg);
+      const port = options.port || defaultPort;
+      const _envSpinner = startSpinner(
+        `Fetching environment variables for ${appName}...`
+      );
+      let envVars = {};
+      try {
+        const variables = await client2.envVariable.list.query({
+          applicationId,
+          includeValues: true
+        });
+        envVars = envVarsToObject(variables);
+        succeedSpinner(
+          `Loaded ${Object.keys(envVars).length} environment variables`
+        );
+      } catch (err) {
+        failSpinner();
+        throw new CliError(
+          `Failed to fetch environment variables: ${err instanceof Error ? err.message : "Unknown error"}`
+        );
+      }
+      if (options.port) {
+        envVars.PORT = String(port);
+      }
+      const framework = detectFramework(pkg);
+      if (isJsonMode()) {
+        outputData({
+          applicationId,
+          appName,
+          command: devCommand,
+          port,
+          framework: framework?.name || "Unknown",
+          envVarCount: Object.keys(envVars).length,
+          packageManager: pm
+        });
+        return;
+      }
+      log("");
+      log(colors.bold(`Running dev server for ${colors.cyan(appName)}`));
+      log("");
+      log(`  Framework:       ${colors.dim(framework?.name || "Unknown")}`);
+      log(`  Package Manager: ${colors.dim(pm)}`);
+      log(`  Command:         ${colors.dim(devCommand)}`);
+      log(`  Port:            ${colors.dim(String(port))}`);
+      log(
+        `  Env Variables:   ${colors.dim(String(Object.keys(envVars).length))}`
+      );
+      log("");
+      log(colors.dim("\u2500".repeat(50)));
+      log("");
+      const result = await runCommand(devCommand, envVars);
+      if (result.signal) {
+        log("");
+        log(colors.dim(`Process terminated by ${result.signal}`));
+      } else if (result.exitCode !== 0) {
+        log("");
+        log(colors.error(`Process exited with code ${result.exitCode}`));
+        process.exit(result.exitCode);
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+function findApp4(apps, identifier) {
+  const lowerIdentifier = identifier.toLowerCase();
+  return apps.find(
+    (app) => app.applicationId === identifier || app.applicationId.startsWith(identifier) || app.name.toLowerCase() === lowerIdentifier || app.appName?.toLowerCase() === lowerIdentifier
+  );
+}
+
 // src/commands/domains.ts
 function registerDomainsCommands(program2) {
   const domains = program2.command("domains").description("Manage custom domains");
@@ -2407,7 +3092,7 @@ function registerDomainsCommands(program2) {
       let domainsList;
       if (appIdentifier) {
         const apps = await client2.application.allByOrganization.query();
-        const app = findApp3(apps, appIdentifier);
+        const app = findApp5(apps, appIdentifier);
         if (!app) {
           failSpinner();
           const suggestions = findSimilar(
@@ -2469,7 +3154,7 @@ function registerDomainsCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Finding application...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp3(apps, appIdentifier);
+      const app = findApp5(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2606,7 +3291,7 @@ function registerDomainsCommands(program2) {
     }
   });
 }
-function findApp3(apps, identifier) {
+function findApp5(apps, identifier) {
   const lowerIdentifier = identifier.toLowerCase();
   return apps.find(
     (app) => app.applicationId === identifier || app.applicationId.startsWith(identifier) || app.name.toLowerCase() === lowerIdentifier || app.appName?.toLowerCase() === lowerIdentifier
@@ -2629,7 +3314,7 @@ function updateSpinner2(text) {
 }
 
 // src/commands/env.ts
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 function registerEnvCommands(program2) {
   const env = program2.command("env").argument("<app>", "Application ID or name").description("Manage environment variables");
   env.command("list").alias("ls").description("List all environment variables").option("--reveal", "Show actual values (not masked)").action(async (options, command) => {
@@ -2639,7 +3324,7 @@ function registerEnvCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Fetching environment variables...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp4(apps, appIdentifier);
+      const app = findApp6(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2704,7 +3389,7 @@ function registerEnvCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Setting environment variable...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp4(apps, appIdentifier);
+      const app = findApp6(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2750,7 +3435,7 @@ function registerEnvCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Removing environment variable...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp4(apps, appIdentifier);
+      const app = findApp6(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2780,7 +3465,7 @@ function registerEnvCommands(program2) {
       const client2 = getApiClient();
       const _spinner = startSpinner("Downloading environment variables...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp4(apps, appIdentifier);
+      const app = findApp6(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2789,7 +3474,7 @@ function registerEnvCommands(program2) {
         );
         throw new NotFoundError("Application", appIdentifier, suggestions);
       }
-      if (existsSync(options.output) && !shouldSkipConfirmation()) {
+      if (existsSync3(options.output) && !shouldSkipConfirmation()) {
         succeedSpinner();
         const confirmed = await confirm(
           `File ${options.output} already exists. Overwrite?`,
@@ -2805,7 +3490,7 @@ function registerEnvCommands(program2) {
         format: "dotenv",
         maskSecrets: !options.reveal
       });
-      writeFileSync(options.output, result.content);
+      writeFileSync2(options.output, result.content);
       succeedSpinner(`Saved to ${options.output}`);
       if (isJsonMode()) {
         outputData({ file: options.output, content: result.content });
@@ -2820,14 +3505,14 @@ function registerEnvCommands(program2) {
     try {
       if (!isLoggedIn()) throw new AuthError();
       const appIdentifier = command.parent.parent.args[0];
-      if (!existsSync(options.input)) {
+      if (!existsSync3(options.input)) {
         throw new InvalidArgumentError(`File not found: ${options.input}`);
       }
-      const content = readFileSync(options.input, "utf-8");
+      const content = readFileSync3(options.input, "utf-8");
       const client2 = getApiClient();
       const _spinner = startSpinner("Uploading environment variables...");
       const apps = await client2.application.allByOrganization.query();
-      const app = findApp4(apps, appIdentifier);
+      const app = findApp6(apps, appIdentifier);
       if (!app) {
         failSpinner();
         const suggestions = findSimilar(
@@ -2856,7 +3541,7 @@ function registerEnvCommands(program2) {
     }
   });
 }
-function findApp4(apps, identifier) {
+function findApp6(apps, identifier) {
   const lowerIdentifier = identifier.toLowerCase();
   return apps.find(
     (app) => app.applicationId === identifier || app.applicationId.startsWith(identifier) || app.name.toLowerCase() === lowerIdentifier || app.appName?.toLowerCase() === lowerIdentifier
@@ -2872,6 +3557,253 @@ function formatDate4(date) {
   return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
 }
 
+// src/commands/link.ts
+import { basename } from "path";
+function registerLinkCommands(program2) {
+  program2.command("link").argument(
+    "[app]",
+    "Application ID or name (optional, will prompt if not provided)"
+  ).description("Link local directory to a Tarout application").option("-y, --yes", "Skip confirmation prompts").action(async (appIdentifier, options) => {
+    try {
+      if (!isLoggedIn()) throw new AuthError();
+      const profile = getCurrentProfile();
+      if (!profile) throw new AuthError();
+      const client2 = getApiClient();
+      const cwd = process.cwd();
+      const dirName = basename(cwd);
+      if (isProjectLinked()) {
+        const existingConfig = getProjectConfig();
+        if (existingConfig && !shouldSkipConfirmation() && !options.yes) {
+          log("");
+          log(
+            `This directory is already linked to ${colors.cyan(existingConfig.name)}`
+          );
+          log(`Application ID: ${colors.dim(existingConfig.applicationId)}`);
+          log("");
+          const confirmed = await confirm(
+            "Do you want to relink to a different application?",
+            false
+          );
+          if (!confirmed) {
+            log("Cancelled.");
+            return;
+          }
+        }
+      }
+      const _spinner = startSpinner("Fetching applications...");
+      const apps = await client2.application.allByOrganization.query();
+      succeedSpinner();
+      if (apps.length === 0) {
+        log("");
+        log("No applications found in your organization.");
+        log("");
+        log(`Create one with: ${colors.dim("tarout apps create <name>")}`);
+        return;
+      }
+      let selectedApp = null;
+      if (appIdentifier) {
+        selectedApp = findApp7(apps, appIdentifier) || null;
+        if (!selectedApp) {
+          const suggestions = findSimilar(
+            appIdentifier,
+            apps.map((a) => a.name)
+          );
+          throw new NotFoundError("Application", appIdentifier, suggestions);
+        }
+      } else {
+        log("");
+        log(`Linking ${colors.cyan(dirName)} to a Tarout application`);
+        log("");
+        const choices = apps.map(
+          (app) => ({
+            name: `${app.name} ${colors.dim(`(${app.applicationId.slice(0, 8)})`)}`,
+            value: app.applicationId
+          })
+        );
+        const selectedId = await select("Select an application:", choices);
+        selectedApp = apps.find(
+          (a) => a.applicationId === selectedId
+        ) || null;
+      }
+      if (!selectedApp) {
+        log("No application selected.");
+        return;
+      }
+      setProjectConfig({
+        applicationId: selectedApp.applicationId,
+        name: selectedApp.name,
+        organizationId: profile.organizationId,
+        linkedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      if (isJsonMode()) {
+        outputData({
+          linked: true,
+          applicationId: selectedApp.applicationId,
+          name: selectedApp.name,
+          directory: cwd
+        });
+        return;
+      }
+      quietOutput(selectedApp.applicationId);
+      box("Project Linked", [
+        `Application: ${colors.cyan(selectedApp.name)}`,
+        `ID: ${colors.dim(selectedApp.applicationId)}`,
+        `Directory: ${colors.dim(cwd)}`
+      ]);
+      log("You can now use:");
+      log(
+        `  ${colors.dim("tarout dev")}     - Run dev server with cloud env vars`
+      );
+      log(
+        `  ${colors.dim("tarout build")}   - Build locally with cloud env vars`
+      );
+      log(`  ${colors.dim("tarout deploy")}  - Deploy to cloud`);
+      log("");
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  program2.command("unlink").description("Unlink the current directory from Tarout").action(async () => {
+    try {
+      const config2 = getProjectConfig();
+      if (!config2) {
+        log("");
+        log("This directory is not linked to any Tarout application.");
+        log("");
+        log(`Link with: ${colors.dim("tarout link")}`);
+        return;
+      }
+      if (!shouldSkipConfirmation()) {
+        log("");
+        log(`Currently linked to: ${colors.cyan(config2.name)}`);
+        log(`Application ID: ${colors.dim(config2.applicationId)}`);
+        log("");
+        const confirmed = await confirm(
+          "Are you sure you want to unlink this directory?",
+          false
+        );
+        if (!confirmed) {
+          log("Cancelled.");
+          return;
+        }
+      }
+      const removed = removeProjectConfig();
+      if (isJsonMode()) {
+        outputData({
+          unlinked: removed,
+          applicationId: config2.applicationId,
+          name: config2.name
+        });
+        return;
+      }
+      if (removed) {
+        log("");
+        log(colors.success(`Unlinked from ${config2.name}`));
+        log("");
+      } else {
+        log("");
+        log(colors.warn("Could not remove project configuration."));
+        log("");
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  program2.command("status").description("Show link status for current directory").action(async () => {
+    try {
+      const config2 = getProjectConfig();
+      if (!config2) {
+        if (isJsonMode()) {
+          outputData({ linked: false });
+          return;
+        }
+        log("");
+        log("This directory is not linked to any Tarout application.");
+        log("");
+        log(`Link with: ${colors.dim("tarout link")}`);
+        return;
+      }
+      if (isLoggedIn()) {
+        const client2 = getApiClient();
+        const _spinner = startSpinner("Fetching application status...");
+        try {
+          const app = await client2.application.one.query({
+            applicationId: config2.applicationId
+          });
+          succeedSpinner();
+          if (isJsonMode()) {
+            outputData({
+              linked: true,
+              applicationId: config2.applicationId,
+              name: config2.name,
+              status: app.applicationStatus,
+              url: app.cloudServiceUrl,
+              linkedAt: config2.linkedAt
+            });
+            return;
+          }
+          log("");
+          log(colors.bold("Project Status"));
+          log("");
+          log(`Application: ${colors.cyan(app.name)}`);
+          log(`ID: ${colors.dim(config2.applicationId)}`);
+          log(`Status: ${getStatusIndicator(app.applicationStatus)}`);
+          if (app.cloudServiceUrl) {
+            log(`URL: ${colors.cyan(app.cloudServiceUrl)}`);
+          }
+          log(`Linked: ${new Date(config2.linkedAt).toLocaleString()}`);
+          log("");
+        } catch {
+          failSpinner();
+          log("");
+          log(colors.warn("Warning: Could not fetch application status."));
+          log("The application may have been deleted.");
+          log("");
+          log(`Unlink with: ${colors.dim("tarout unlink")}`);
+          log("");
+        }
+      } else {
+        if (isJsonMode()) {
+          outputData({
+            linked: true,
+            applicationId: config2.applicationId,
+            name: config2.name,
+            linkedAt: config2.linkedAt
+          });
+          return;
+        }
+        log("");
+        log(colors.bold("Project Status"));
+        log("");
+        log(`Application: ${colors.cyan(config2.name)}`);
+        log(`ID: ${colors.dim(config2.applicationId)}`);
+        log(`Linked: ${new Date(config2.linkedAt).toLocaleString()}`);
+        log("");
+        log(colors.dim("Log in to see full application status."));
+        log("");
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+function findApp7(apps, identifier) {
+  const lowerIdentifier = identifier.toLowerCase();
+  return apps.find(
+    (app) => app.applicationId === identifier || app.applicationId.startsWith(identifier) || app.name.toLowerCase() === lowerIdentifier || app.appName?.toLowerCase() === lowerIdentifier
+  );
+}
+function getStatusIndicator(status) {
+  const indicators = {
+    running: colors.success("running"),
+    idle: colors.warn("idle"),
+    error: colors.error("error"),
+    deploying: colors.info("deploying"),
+    stopped: colors.dim("stopped")
+  };
+  return indicators[status.toLowerCase()] || status;
+}
+
 // src/commands/orgs.ts
 function registerOrgsCommands(program2) {
   const orgs = program2.command("orgs").description("Manage organizations");
@@ -3060,4 +3992,7 @@ registerDbCommands(program);
 registerDomainsCommands(program);
 registerOrgsCommands(program);
 registerEnvsCommands(program);
+registerLinkCommands(program);
+registerDevCommand(program);
+registerBuildCommand(program);
 program.parse();

package/dist/prompts-B53LIJLG.js

@@ -0,0 +1,12 @@
+import {
+  confirm,
+  input,
+  password,
+  select
+} from "./chunk-VO4OYJW3.js";
+export {
+  confirm,
+  input,
+  password,
+  select
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tarout/cli",
-	"version": "0.1.4",
+	"version": "0.2.0",
 	"description": "Tarout PaaS Command Line Interface",
 	"type": "module",
 	"bin": {