cassian-cli 0.2.0 → 0.3.0

package/dist/commands/init.js

@@ -32,8 +32,13 @@ function promptChoice(rl, question, choices, fallback) {
 }
 function buildYaml(opts) {
     const volName = opts.name.replace(/[^a-z0-9-]/g, "-") + "-data";
-    const syncignoreLines = opts.syncignore.map(p => `    - "${p}"`).join("\n");
     const setupLine = opts.setup ? `  setup: ${opts.setup}\n` : "";
+    const noSyncLines = opts.noSync.length
+        ? `  no_sync:\n${opts.noSync.map(p => `    - "${p}"`).join("\n")}\n` : "";
+    const storageLines = opts.storage.length
+        ? `  storage:\n${opts.storage.map(p => `    - "${p}"`).join("\n")}\n` : "";
+    const excludeLines = opts.exclude.length
+        ? `  exclude:\n${opts.exclude.map(p => `    - "${p}"`).join("\n")}\n` : "";
     return `name: ${opts.name}
 
 gpu:
@@ -52,9 +57,7 @@ resources:
   shm_size: ${opts.shmSize}
 
 workspace:
-${setupLine}  syncignore:
-${syncignoreLines}
-`;
+${setupLine}${noSyncLines}${storageLines}${excludeLines}`;
 }
 export async function init(options = {}) {
     if (existsSync("cassian.yaml")) {
@@ -65,9 +68,6 @@ export async function init(options = {}) {
     // If all required flags are provided, skip the wizard entirely
     const allFlagsProvided = !!(options.name && options.gpu && options.gpuCount && options.memory && options.disk);
     if (allFlagsProvided || skipPrompts) {
-        const syncignore = options.syncignore
-            ? options.syncignore.split(",").map(s => s.trim()).filter(Boolean)
-            : ["outputs/**", "*.ckpt", "*.safetensors", "**/.cache/**"];
         const yaml = buildYaml({
             name: options.name || dirName,
             gpuType: options.gpu || "rtx3090",
@@ -76,7 +76,9 @@ export async function init(options = {}) {
             shmSize: options.shm || "16G",
             diskSize: options.disk || "50G",
             setup: options.setup || (existsSync("requirements.txt") ? "pip install -r /workspace/requirements.txt" : ""),
-            syncignore,
+            noSync: ["checkpoints/", "outputs/"],
+            storage: [],
+            exclude: ["node_modules/", ".venv/", "__pycache__/", "*.pyc", "wandb/"],
         });
         writeFileSync("cassian.yaml", yaml);
         console.log();
@@ -122,13 +124,27 @@ export async function init(options = {}) {
     const setupRaw = options.setup ?? await prompt(rl, `  Setup command ${dim(`[${defaultSetup || "skip"}]`)}: `, defaultSetup);
     const setup = setupRaw === "skip" ? "" : setupRaw;
     console.log();
-    console.log(dim("  Patterns to exclude from sync (comma-separated, or enter for defaults)."));
-    const syncignoreRaw = options.syncignore ?? await prompt(rl, `  Syncignore ${dim("[outputs/**, *.ckpt, *.safetensors, **/.cache/**]")}: `, "");
-    const syncignore = syncignoreRaw
-        ? syncignoreRaw.split(",").map(s => s.trim()).filter(Boolean)
-        : ["outputs/**", "*.ckpt", "*.safetensors", "**/.cache/**"];
+    console.log(dim("  Folders that stay on the GPU instance but don't sync to your machine"));
+    console.log(dim("  (large files like checkpoints, training outputs — still persists across sessions)"));
+    const noSyncRaw = options.syncignore ?? await prompt(rl, `  No-sync folders ${dim("[checkpoints/, outputs/]")}: `, "");
+    const noSync = noSyncRaw
+        ? noSyncRaw.split(",").map(s => s.trim()).filter(Boolean)
+        : ["checkpoints/", "outputs/"];
+    console.log();
+    console.log(dim("  Folders streamed from cloud storage (huge datasets, pretrained models)"));
+    console.log(dim("  (doesn't use instance disk — reads directly from cloud)"));
+    const storageRaw = await prompt(rl, `  Cloud storage folders ${dim("[none]")}: `, "");
+    const storage = storageRaw
+        ? storageRaw.split(",").map(s => s.trim()).filter(Boolean)
+        : [];
+    console.log();
+    console.log(dim("  Folders to exclude entirely (build artifacts, can be recreated)"));
+    const excludeRaw = await prompt(rl, `  Exclude ${dim("[node_modules/, .venv/, __pycache__/, *.pyc, wandb/]")}: `, "");
+    const exclude = excludeRaw
+        ? excludeRaw.split(",").map(s => s.trim()).filter(Boolean)
+        : ["node_modules/", ".venv/", "__pycache__/", "*.pyc", "wandb/"];
     rl.close();
-    const yaml = buildYaml({ name, gpuType, gpuCount, memory, shmSize, diskSize, setup, syncignore });
+    const yaml = buildYaml({ name, gpuType, gpuCount, memory, shmSize, diskSize, setup, noSync, storage, exclude });
     writeFileSync("cassian.yaml", yaml);
     console.log();
     console.log(`  ${green("✓")} Created cassian.yaml`);

package/dist/commands/sync.js

@@ -1,6 +1,5 @@
 import * as tar from "tar";
-import { mkdirSync, existsSync, readdirSync, unlinkSync, statSync } from "fs";
-import { join, normalize } from "path";
+import { mkdirSync } from "fs";
 import { Readable } from "stream";
 import ora from "ora";
 import { ApiClient } from "../lib/api.js";
@@ -26,55 +25,46 @@ export async function sync() {
         const tarBuf = await client.pull(instance.id, mountPath);
         const cwd = process.cwd();
         mkdirSync(cwd, { recursive: true });
-        // Build ignored set (same as push — only reconcile within sync scope)
-        const syncignore = config.workspace?.syncignore ?? [];
-        const defaultIgnore = ["**/.git/**", "**/node_modules/**", "**/__pycache__/**", "**/*.pyc", "**/.DS_Store", ...syncignore];
-        const ignoreRegexes = defaultIgnore.map((p) => {
+        // Build skip patterns from all workspace config fields
+        const patterns = ["**/.git/**", "**/.DS_Store"];
+        if (config.workspace?.syncignore)
+            patterns.push(...config.workspace.syncignore);
+        if (config.workspace?.no_sync) {
+            for (const p of config.workspace.no_sync) {
+                patterns.push(p.endsWith("/") ? `${p}**` : `**/${p}/**`);
+            }
+        }
+        if (config.workspace?.storage) {
+            for (const p of config.workspace.storage) {
+                patterns.push(p.endsWith("/") ? `${p}**` : `**/${p}/**`);
+            }
+        }
+        if (config.workspace?.exclude) {
+            for (const p of config.workspace.exclude) {
+                if (p.endsWith("/"))
+                    patterns.push(`${p}**`);
+                else if (p.includes("*"))
+                    patterns.push(`**/${p}`);
+                else
+                    patterns.push(`**/${p}/**`);
+            }
+        }
+        const ignoreRegexes = patterns.map((p) => {
             const esc = p.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\x00").replace(/\*/g, "[^/]*").replace(/\x00/g, ".*");
             return new RegExp(`(^|/)${esc}($|/)`);
         });
-        // Collect remote file set from tar
-        const remoteFiles = new Set();
-        await new Promise((res) => {
-            const parser = new tar.Parser({
-                onentry: (entry) => {
-                    const stripped = entry.path.replace(/^[^/]+\//, "");
-                    const norm = normalize(stripped);
-                    if (stripped && !norm.startsWith("..") && !norm.startsWith("/"))
-                        remoteFiles.add(norm);
-                    entry.resume();
-                },
-            });
-            Readable.from(tarBuf).pipe(parser)
-                .on("finish", res).on("error", res);
-        });
-        // Delete local synced files not in remote
-        function walk(dir) {
-            if (!existsSync(dir))
-                return [];
-            return readdirSync(dir).flatMap((e) => {
-                const full = join(dir, e);
-                const rel = full.slice(cwd.length + 1);
-                if (ignoreRegexes.some((re) => re.test(rel)))
-                    return [];
-                try {
-                    return statSync(full).isDirectory() ? walk(full) : [rel];
-                }
-                catch {
-                    return [];
-                }
-            });
-        }
-        for (const f of walk(cwd)) {
-            if (!remoteFiles.has(normalize(f))) {
-                try {
-                    unlinkSync(join(cwd, f));
-                }
-                catch { /* skip */ }
-            }
+        function shouldSkip(rel) {
+            return ignoreRegexes.some((re) => re.test(rel));
         }
-        // Extract
-        await new Promise((res, rej) => Readable.from(tarBuf).pipe(tar.extract({ cwd, strip: 1 })).on("finish", res).on("error", rej));
+        // Extract with filtering
+        await new Promise((res, rej) => Readable.from(tarBuf).pipe(tar.extract({
+            cwd,
+            strip: 1,
+            filter: (path) => {
+                const stripped = path.replace(/^\.\//, "");
+                return !shouldSkip(stripped);
+            },
+        })).on("finish", res).on("error", rej));
         spinner.succeed("Files synced");
     }
     catch (err) {

package/dist/commands/up.js

@@ -128,6 +128,11 @@ export async function up() {
                 shm_size: config.resources?.shm_size || null,
                 cpus: config.resources?.cpus || null,
             },
+            workspace: {
+                no_sync: config.workspace?.no_sync || [],
+                storage: config.workspace?.storage || [],
+                exclude: config.workspace?.exclude || config.workspace?.syncignore || [],
+            },
         });
         spinner.succeed("Instance ready");
         // Sync happens during ssh/exec, not during up

package/dist/lib/errors.js

@@ -42,14 +42,15 @@ function translateApiError(err) {
         case 404:
             fatal("Instance not found.", "Run: cassian up");
         case 409:
-            fatal("An instance with this name already exists.", "Run: cassian down, then try again.");
+            fatal(err.detail || "An instance with this name already exists.", "Run: cassian down, then try again.");
         case 422:
             fatal(`Invalid configuration: ${err.detail}`);
         case 429:
             fatal("Too many requests.", "Wait a moment and try again.");
+        case 503:
+            fatal(err.detail || "No GPUs available right now.", "Try again in a moment or reduce gpu.count in cassian.yaml.");
         case 500:
         case 502:
-        case 503:
         case 504:
             fatal("Something went wrong on our end.", "Try again in a moment. Still broken? Reach out at trycassian.com.");
         default:

package/dist/lib/push.js

@@ -1,9 +1,32 @@
 export async function pushWorkspace(client, instanceId, config) {
     const tar = await import("tar");
     const mountPath = config.volumes?.[0]?.mount || "/workspace";
-    const syncignore = config.workspace?.syncignore ?? [];
-    const defaultIgnore = ["**/.git/**", "**/node_modules/**", "**/__pycache__/**", "**/*.pyc", "**/.DS_Store", ...syncignore];
-    const ignoreRegexes = defaultIgnore.map((p) => {
+    // Build ignore list from all workspace fields
+    const patterns = ["**/.git/**", "**/.DS_Store"];
+    if (config.workspace?.syncignore)
+        patterns.push(...config.workspace.syncignore);
+    if (config.workspace?.no_sync) {
+        for (const p of config.workspace.no_sync) {
+            patterns.push(p.endsWith("/") ? `${p}**` : `**/${p}/**`);
+        }
+    }
+    if (config.workspace?.storage) {
+        for (const p of config.workspace.storage) {
+            const name = p.replace(/\/$/, "");
+            patterns.push(`${name}`, `${name}/**`);
+        }
+    }
+    if (config.workspace?.exclude) {
+        for (const p of config.workspace.exclude) {
+            if (p.endsWith("/"))
+                patterns.push(`${p}**`);
+            else if (p.includes("*"))
+                patterns.push(`**/${p}`);
+            else
+                patterns.push(`**/${p}/**`);
+        }
+    }
+    const ignoreRegexes = patterns.map((p) => {
         const esc = p.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\x00").replace(/\*/g, "[^/]*").replace(/\x00/g, ".*");
         return new RegExp(`(^|/)${esc}($|/)`);
     });

package/dist/lib/watcher.js

@@ -15,13 +15,42 @@ import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync, statSyn
 import { resolve, dirname, normalize } from "path";
 import { getCredentials, isTokenExpired, refreshToken } from "./auth.js";
 const POLL_INTERVAL_MS = 2000;
-const MAX_FILE_SIZE = 512 * 1024; // 512KB — skip large files (weights, checkpoints)
-function buildIgnorePatterns(syncignore) {
-    return [
-        "**/.git/**", "**/node_modules/**", "**/__pycache__/**",
-        "**/*.pyc", "**/.DS_Store",
-        ...syncignore,
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
+function buildIgnorePatterns(config) {
+    const patterns = [
+        "**/.git/**", "**/.DS_Store",
     ];
+    // Legacy syncignore
+    if (config.workspace?.syncignore)
+        patterns.push(...config.workspace.syncignore);
+    // no_sync: persists to cloud but doesn't sync to laptop
+    if (config.workspace?.no_sync) {
+        for (const p of config.workspace.no_sync) {
+            patterns.push(p.endsWith("/") ? `${p}**` : `**/${p}/**`);
+        }
+    }
+    // storage: cold paths, don't sync to laptop (exclude the name itself + contents)
+    if (config.workspace?.storage) {
+        for (const p of config.workspace.storage) {
+            const name = p.replace(/\/$/, "");
+            patterns.push(name, `${name}/**`);
+        }
+    }
+    // exclude: throwaway, don't sync to laptop
+    if (config.workspace?.exclude) {
+        for (const p of config.workspace.exclude) {
+            if (p.endsWith("/")) {
+                patterns.push(`${p}**`);
+            }
+            else if (p.includes("*")) {
+                patterns.push(`**/${p}`);
+            }
+            else {
+                patterns.push(`**/${p}/**`);
+            }
+        }
+    }
+    return patterns;
 }
 function globToRegex(pattern) {
     const esc = pattern
@@ -41,8 +70,7 @@ async function getToken() {
 }
 export function startBidirectionalSync(instanceId, config, agentUrl) {
     const mountPath = config.volumes?.[0]?.mount ?? "/workspace";
-    const syncignore = config.workspace?.syncignore ?? [];
-    const ignoreRegexes = buildIgnorePatterns(syncignore).map(globToRegex);
+    const ignoreRegexes = buildIgnorePatterns(config).map(globToRegex);
     const cwd = process.cwd();
     let stopped = false;
     // Track files recently pushed by us so we don't pull-echo them back

package/dist/types.d.ts

@@ -24,6 +24,9 @@ export interface CassianConfig {
     workspace?: {
         setup?: string;
         syncignore?: string[];
+        no_sync?: string[];
+        storage?: string[];
+        exclude?: string[];
     };
 }
 export interface DevOverrides {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cassian-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The Cassian GPU cloud CLI — provision GPUs, sync files, and run workloads from your terminal.",
   "type": "module",
   "bin": {