clawon 0.1.11 → 0.1.12

package/README.md

@@ -56,9 +56,27 @@ npx clawon schedule off
 npx clawon schedule status
 ```
 
+### Workspaces
+
+Workspaces organize your cloud snapshots by machine or environment — like GitHub repos for your backups. A default workspace is created automatically on login.
+
+```bash
+# List your workspaces
+npx clawon workspaces list
+
+# Create a new workspace
+npx clawon workspaces create "Work Server"
+
+# Switch active workspace (affects backup/restore/list)
+npx clawon workspaces switch work-server
+
+# Show current workspace info
+npx clawon workspaces info
+```
+
 ### Cloud Backups (requires account)
 
-Cloud backups sync your workspace to Clawon's servers for cross-machine access.
+Cloud backups sync your workspace to Clawon's servers for cross-machine access. Snapshots are scoped to your current workspace.
 
 ```bash
 # Authenticate (env var recommended to avoid shell history)
@@ -72,7 +90,7 @@ npx clawon login --api-key <your-key>
 npx clawon backup
 npx clawon backup --tag "stable config"
 npx clawon backup --dry-run             # Preview without uploading
-npx clawon backup --include-memory-db   # Requires Pro account
+npx clawon backup --include-memory-db   # Requires Hobby or Pro
 npx clawon backup --include-sessions    # Requires Hobby or Pro
 
 # List cloud backups
@@ -97,7 +115,7 @@ npx clawon discover    # Show exactly which files would be backed up
 npx clawon discover --include-memory-db  # Include SQLite memory index
 npx clawon discover --include-sessions   # Include chat history
 npx clawon schedule status  # Show active schedules
-npx clawon status      # Connection status and file count
+npx clawon status      # Connection status, workspace, and file count
 npx clawon logout      # Remove local credentials
 ```
 
@@ -169,7 +187,7 @@ Each archive contains:
 
 ## Configuration
 
-Config is stored at `~/.clawon/config.json` after running `clawon login`. Contains your API key, profile ID, and API URL. Run `clawon logout` to remove it.
+Config is stored at `~/.clawon/config.json` after running `clawon login`. Contains your API key, profile ID, workspace, and API URL. Run `clawon logout` to remove it.
 
 ## Telemetry
 

package/dist/index.js

@@ -255,12 +255,19 @@ program.command("login").description("Connect to Clawon with your API key").opti
     writeConfig({
       apiKey,
       profileId: connectJson.profileId,
+      workspaceId: connectJson.workspaceId || void 0,
+      workspaceSlug: connectJson.workspaceSlug || void 0,
       apiBaseUrl: opts.apiUrl,
       connectedAt: (/* @__PURE__ */ new Date()).toISOString()
     });
     console.log("\u2713 Logged in");
     console.log(`  Profile ID: ${connectJson.profileId}`);
-    trackCliEvent(connectJson.profileId, "cli_login");
+    if (connectJson.workspaceSlug) {
+      console.log(`  Workspace: ${connectJson.workspaceSlug}`);
+    }
+    trackCliEvent(connectJson.profileId, "cli_login", {
+      workspace_slug: connectJson.workspaceSlug
+    });
   } catch (e) {
     console.error(`\u2717 Login failed: ${e.message}`);
     process.exit(1);
@@ -268,7 +275,7 @@ program.command("login").description("Connect to Clawon with your API key").opti
 });
 program.command("backup").description("Backup your OpenClaw workspace to the cloud").option("--dry-run", "Show what would be backed up without uploading").option("--tag <label>", "Add a label to this backup").option("--include-memory-db", "Include SQLite memory index").option("--include-sessions", "Include chat history (sessions)").option("--scheduled", "Internal: triggered by cron (suppresses interactive output)").action(async (opts) => {
   if (opts.includeMemoryDb) {
-    console.error("\u2717 Memory DB cloud backup requires a Pro account. Use `clawon local backup --include-memory-db` for local backups.");
+    console.error("\u2717 Memory DB cloud backup requires a Hobby or Pro account. Use `clawon local backup --include-memory-db` for local backups.");
     process.exit(1);
   }
   if (opts.includeSessions) {
@@ -280,6 +287,11 @@ program.command("backup").description("Backup your OpenClaw workspace to the clo
     console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
     process.exit(1);
   }
+  if (!cfg.workspaceId) {
+    console.error("\u2717 No workspace selected. Run: clawon workspaces switch <slug>");
+    console.error("  Or re-login: clawon login --api-key <key>");
+    process.exit(1);
+  }
   if (!fs.existsSync(OPENCLAW_DIR)) {
     console.error(`\u2717 OpenClaw directory not found: ${OPENCLAW_DIR}`);
     process.exit(1);
@@ -314,6 +326,7 @@ program.command("backup").description("Backup your OpenClaw workspace to the clo
       cfg.apiKey,
       {
         profileId: cfg.profileId,
+        workspaceId: cfg.workspaceId,
         files: files.map((f) => ({ path: f.path, size: f.size })),
         ...opts.tag ? { tag: opts.tag } : {}
       }
@@ -350,6 +363,7 @@ program.command("backup").description("Backup your OpenClaw workspace to the clo
       include_memory_db: !!opts.includeMemoryDb,
       include_sessions: !!opts.includeSessions,
       type: "cloud",
+      workspace_slug: cfg.workspaceSlug,
       trigger: opts.scheduled ? "scheduled" : "manual"
     });
   } catch (e) {
@@ -434,9 +448,10 @@ program.command("list").description("List your backups").option("--limit <n>", "
     process.exit(1);
   }
   try {
+    const wsParam = cfg.workspaceId ? `&workspaceId=${cfg.workspaceId}` : "";
     const { snapshots } = await api(
       cfg.apiBaseUrl,
-      `/api/v1/snapshots/list?profileId=${cfg.profileId}&limit=${opts.limit}`,
+      `/api/v1/snapshots/list?profileId=${cfg.profileId}&limit=${opts.limit}${wsParam}`,
       "GET",
       cfg.apiKey
     );
@@ -444,6 +459,10 @@ program.command("list").description("List your backups").option("--limit <n>", "
       console.log("No backups yet. Run: clawon backup");
       return;
     }
+    if (cfg.workspaceSlug) {
+      console.log(`Workspace: ${cfg.workspaceSlug}
+`);
+    }
     console.log("Your backups:\n");
     console.log("ID                                   | Date                 | Files | Size     | Tag");
     console.log("\u2500".repeat(100));
@@ -916,12 +935,151 @@ local.command("restore").description("Restore from a local backup").option("--fi
     process.exit(1);
   }
 });
+var workspaces = program.command("workspaces").description("Manage workspaces");
+workspaces.command("list").description("List your workspaces").action(async () => {
+  const cfg = readConfig();
+  if (!cfg) {
+    console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
+    process.exit(1);
+  }
+  try {
+    const { workspaces: wsList } = await api(
+      cfg.apiBaseUrl,
+      `/api/v1/workspaces/list?profileId=${cfg.profileId}`,
+      "GET",
+      cfg.apiKey
+    );
+    if (!wsList?.length) {
+      console.log("No workspaces yet.");
+      return;
+    }
+    console.log("Your workspaces:\n");
+    console.log("Name                 | Slug                 | Snapshots | Last Backup");
+    console.log("\u2500".repeat(80));
+    for (const ws of wsList) {
+      const lastBackup = ws.lastBackupAt ? new Date(ws.lastBackupAt).toLocaleString() : "Never";
+      const current = ws.id === cfg.workspaceId ? " \u2190 current" : "";
+      console.log(
+        `${ws.name.padEnd(20)} | ${ws.slug.padEnd(20)} | ${String(ws.snapshotCount).padEnd(9)} | ${lastBackup}${current}`
+      );
+    }
+    console.log(`
+Total: ${wsList.length} workspace(s)`);
+    trackCliEvent(cfg.profileId, "cli_workspaces_listed", { count: wsList.length });
+  } catch (e) {
+    console.error(`\u2717 Failed to list workspaces: ${e.message}`);
+    process.exit(1);
+  }
+});
+workspaces.command("create <name>").description("Create a new workspace").option("--description <desc>", "Workspace description").action(async (name, opts) => {
+  const cfg = readConfig();
+  if (!cfg) {
+    console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
+    process.exit(1);
+  }
+  try {
+    const { workspace } = await api(
+      cfg.apiBaseUrl,
+      "/api/v1/workspaces/create",
+      "POST",
+      cfg.apiKey,
+      {
+        profileId: cfg.profileId,
+        name,
+        ...opts.description ? { description: opts.description } : {}
+      }
+    );
+    console.log(`\u2713 Workspace created`);
+    console.log(`  Name: ${workspace.name}`);
+    console.log(`  Slug: ${workspace.slug}`);
+    console.log(`
+Switch to it: clawon workspaces switch ${workspace.slug}`);
+    trackCliEvent(cfg.profileId, "workspace_created", { name, slug: workspace.slug });
+  } catch (e) {
+    console.error(`\u2717 Failed to create workspace: ${e.message}`);
+    process.exit(1);
+  }
+});
+workspaces.command("switch <slug>").description("Switch to a different workspace").action(async (slug) => {
+  const cfg = readConfig();
+  if (!cfg) {
+    console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
+    process.exit(1);
+  }
+  try {
+    const { workspaces: wsList } = await api(
+      cfg.apiBaseUrl,
+      `/api/v1/workspaces/list?profileId=${cfg.profileId}`,
+      "GET",
+      cfg.apiKey
+    );
+    const target = (wsList || []).find((w) => w.slug === slug);
+    if (!target) {
+      console.error(`\u2717 Workspace "${slug}" not found.`);
+      console.error("  Available workspaces:");
+      for (const ws of wsList || []) {
+        console.error(`    \u2022 ${ws.slug}`);
+      }
+      process.exit(1);
+    }
+    const previousSlug = cfg.workspaceSlug;
+    updateConfig({ workspaceId: target.id, workspaceSlug: target.slug });
+    console.log(`\u2713 Switched to workspace: ${target.name} (${target.slug})`);
+    trackCliEvent(cfg.profileId, "workspace_switched", {
+      from_slug: previousSlug,
+      to_slug: target.slug
+    });
+  } catch (e) {
+    console.error(`\u2717 Failed to switch workspace: ${e.message}`);
+    process.exit(1);
+  }
+});
+workspaces.command("info").description("Show current workspace info").action(async () => {
+  const cfg = readConfig();
+  if (!cfg) {
+    console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
+    process.exit(1);
+  }
+  if (!cfg.workspaceId) {
+    console.log("No workspace selected. Run: clawon workspaces switch <slug>");
+    return;
+  }
+  try {
+    const { workspaces: wsList } = await api(
+      cfg.apiBaseUrl,
+      `/api/v1/workspaces/list?profileId=${cfg.profileId}`,
+      "GET",
+      cfg.apiKey
+    );
+    const current = (wsList || []).find((w) => w.id === cfg.workspaceId);
+    if (!current) {
+      console.log("Current workspace not found on server. It may have been deleted.");
+      return;
+    }
+    console.log("Current Workspace\n");
+    console.log(`  Name: ${current.name}`);
+    console.log(`  Slug: ${current.slug}`);
+    console.log(`  Snapshots: ${current.snapshotCount}`);
+    if (current.lastBackupAt) {
+      console.log(`  Last backup: ${new Date(current.lastBackupAt).toLocaleString()}`);
+    }
+    if (current.description) {
+      console.log(`  Description: ${current.description}`);
+    }
+  } catch (e) {
+    console.error(`\u2717 Failed to get workspace info: ${e.message}`);
+    process.exit(1);
+  }
+});
 program.command("status").description("Show current status").action(async () => {
   const cfg = readConfig();
   console.log("Clawon Status\n");
   if (cfg) {
     console.log(`\u2713 Logged in`);
     console.log(`  Profile ID: ${cfg.profileId}`);
+    if (cfg.workspaceSlug) {
+      console.log(`  Workspace: ${cfg.workspaceSlug}`);
+    }
     console.log(`  API: ${cfg.apiBaseUrl}`);
   } else {
     console.log(`\u2717 Not logged in`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawon",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Backup and restore your OpenClaw workspace",
   "type": "module",
   "bin": {