@heysalad/cheri-cli 0.2.0 → 0.3.0

package/src/commands/memory.js

@@ -4,6 +4,86 @@ import { writeFileSync } from "fs";
 import { apiClient } from "../lib/api-client.js";
 import { log } from "../lib/logger.js";
 
+export async function showMemory(options = {}) {
+  const spinner = ora("Fetching memories...").start();
+
+  try {
+    const { memories } = await apiClient.getMemory();
+    spinner.stop();
+
+    log.blank();
+    log.brand("AI Memory");
+    log.blank();
+    log.keyValue("Entries", `${memories.length}`);
+
+    if (memories.length === 0) {
+      log.blank();
+      log.dim("  No memories yet. Use 'memory add <content>' to store context.");
+      log.blank();
+      return;
+    }
+
+    const limit = parseInt(options.limit || "10");
+    const recent = memories.slice(-limit);
+
+    log.keyValue(
+      "Last updated",
+      memories.length > 0
+        ? timeSince(new Date(memories[memories.length - 1].timestamp))
+        : "never"
+    );
+
+    log.blank();
+    log.dim("  Recent memories:");
+
+    recent.forEach((entry) => {
+      const category = chalk.dim(`(${entry.category})`);
+      const content =
+        entry.content.length > 60
+          ? entry.content.slice(0, 60) + "..."
+          : entry.content;
+      console.log(`  ${chalk.dim("-")} "${content}" ${category}`);
+    });
+
+    log.blank();
+  } catch (err) {
+    spinner.fail("Failed to fetch memories");
+    throw err;
+  }
+}
+
+export async function addMemory(content, category = "general") {
+  const { entry, count } = await apiClient.addMemory(content, category);
+  log.success(`Memory saved (${count} total). Category: ${chalk.cyan(entry.category)}`);
+}
+
+export async function clearMemory() {
+  await apiClient.clearMemory();
+  log.success("All memories cleared.");
+}
+
+export async function exportMemory(options = {}) {
+  const spinner = ora("Exporting memories...").start();
+
+  try {
+    const { memories } = await apiClient.getMemory();
+
+    const exportData = {
+      version: "0.1.0",
+      exportedAt: new Date().toISOString(),
+      entryCount: memories.length,
+      entries: memories,
+    };
+
+    const outputFile = options.output || `cheri-memory-export.json`;
+    writeFileSync(outputFile, JSON.stringify(exportData, null, 2));
+    spinner.succeed(`Exported ${memories.length} entries to ${chalk.cyan(outputFile)}`);
+  } catch (err) {
+    spinner.fail("Failed to export memories");
+    throw err;
+  }
+}
+
 export function registerMemoryCommand(program) {
   const memory = program
     .command("memory")
@@ -14,49 +94,9 @@ export function registerMemoryCommand(program) {
     .description("Show current memory entries")
     .option("-l, --limit <n>", "Number of entries to show", "10")
     .action(async (options) => {
-      const spinner = ora("Fetching memories...").start();
-
       try {
-        const { memories } = await apiClient.getMemory();
-        spinner.stop();
-
-        log.blank();
-        log.brand("AI Memory");
-        log.blank();
-        log.keyValue("Entries", `${memories.length}`);
-
-        if (memories.length === 0) {
-          log.blank();
-          log.dim("  No memories yet. Use 'cheri memory add' to store context.");
-          log.blank();
-          return;
-        }
-
-        const limit = parseInt(options.limit);
-        const recent = memories.slice(-limit);
-
-        log.keyValue(
-          "Last updated",
-          memories.length > 0
-            ? timeSince(new Date(memories[memories.length - 1].timestamp))
-            : "never"
-        );
-
-        log.blank();
-        log.dim("  Recent memories:");
-
-        recent.forEach((entry) => {
-          const category = chalk.dim(`(${entry.category})`);
-          const content =
-            entry.content.length > 60
-              ? entry.content.slice(0, 60) + "..."
-              : entry.content;
-          console.log(`  ${chalk.dim("-")} "${content}" ${category}`);
-        });
-
-        log.blank();
+        await showMemory(options);
       } catch (err) {
-        spinner.fail("Failed to fetch memories");
         log.error(err.message);
         process.exit(1);
       }
@@ -69,8 +109,7 @@ export function registerMemoryCommand(program) {
     .option("-c, --category <category>", "Category", "general")
     .action(async (content, options) => {
       try {
-        const { entry, count } = await apiClient.addMemory(content, options.category);
-        log.success(`Memory saved (${count} total). Category: ${chalk.cyan(entry.category)}`);
+        await addMemory(content, options.category);
       } catch (err) {
         log.error(err.message);
         process.exit(1);
@@ -82,8 +121,7 @@ export function registerMemoryCommand(program) {
     .description("Clear all memory")
     .action(async () => {
       try {
-        await apiClient.clearMemory();
-        log.success("All memories cleared.");
+        await clearMemory();
       } catch (err) {
         log.error(err.message);
         process.exit(1);
@@ -95,23 +133,9 @@ export function registerMemoryCommand(program) {
     .description("Export memory to JSON file")
     .option("-o, --output <file>", "Output file path")
     .action(async (options) => {
-      const spinner = ora("Exporting memories...").start();
-
       try {
-        const { memories } = await apiClient.getMemory();
-
-        const exportData = {
-          version: "0.1.0",
-          exportedAt: new Date().toISOString(),
-          entryCount: memories.length,
-          entries: memories,
-        };
-
-        const outputFile = options.output || `cheri-memory-export.json`;
-        writeFileSync(outputFile, JSON.stringify(exportData, null, 2));
-        spinner.succeed(`Exported ${memories.length} entries to ${chalk.cyan(outputFile)}`);
+        await exportMemory(options);
       } catch (err) {
-        spinner.fail("Failed to export memories");
         log.error(err.message);
         process.exit(1);
       }

package/src/commands/status.js

@@ -4,53 +4,63 @@ import { getConfigValue } from "../lib/config-store.js";
 import { apiClient } from "../lib/api-client.js";
 import { log } from "../lib/logger.js";
 
+export async function showStatus() {
+  log.blank();
+  log.brand("Status");
+
+  // Account info
+  log.header("Account");
+  const spinner = ora("Fetching account info...").start();
+
+  try {
+    const me = await apiClient.getMe();
+    spinner.stop();
+
+    log.keyValue("User", chalk.cyan(me.ghLogin || me.userId));
+    log.keyValue("Plan", me.plan === "pro" ? chalk.green("Pro") : "Free");
+  } catch (err) {
+    spinner.stop();
+    log.keyValue("User", chalk.yellow("Not logged in"));
+    log.dim(`  Run ${chalk.cyan("cheri login")} to authenticate.`);
+  }
+
+  // Workspaces
+  log.header("Workspaces");
+  try {
+    const { workspaces } = await apiClient.listWorkspaces();
+    if (workspaces.length === 0) {
+      log.keyValue("Count", "0");
+      log.dim(`  Run ${chalk.cyan("cheri workspace launch owner/repo")} to create one.`);
+    } else {
+      log.keyValue("Count", `${workspaces.length}`);
+      workspaces.forEach((ws) => {
+        const statusIcon = ws.status === "running" ? chalk.green("●") : chalk.dim("○");
+        const statusColor = ws.status === "running" ? chalk.green : chalk.dim;
+        console.log(`    ${statusIcon} ${ws.id} (${ws.repo || ws.id}) — ${statusColor(ws.status)}`);
+      });
+    }
+  } catch {
+    log.dim("  Could not fetch workspaces.");
+  }
+
+  // Config info
+  log.header("Configuration");
+  log.keyValue("API URL", getConfigValue("apiUrl") || "https://cheri.heysalad.app");
+  log.keyValue("Config dir", chalk.dim("~/.cheri/"));
+
+  log.blank();
+}
+
 export function registerStatusCommand(program) {
   program
     .command("status")
     .description("Show account and workspace status")
     .action(async () => {
-      log.blank();
-      log.brand("Status");
-
-      // Account info
-      log.header("Account");
-      const spinner = ora("Fetching account info...").start();
-
       try {
-        const me = await apiClient.getMe();
-        spinner.stop();
-
-        log.keyValue("User", chalk.cyan(me.ghLogin || me.userId));
-        log.keyValue("Plan", me.plan === "pro" ? chalk.green("Pro") : "Free");
+        await showStatus();
       } catch (err) {
-        spinner.stop();
-        log.keyValue("User", chalk.yellow("Not logged in"));
-        log.dim(`  Run ${chalk.cyan("cheri login")} to authenticate.`);
-      }
-
-      // Workspaces
-      log.header("Workspaces");
-      try {
-        const { workspaces } = await apiClient.listWorkspaces();
-        if (workspaces.length === 0) {
-          log.keyValue("Count", "0");
-          log.dim(`  Run ${chalk.cyan("cheri workspace launch owner/repo")} to create one.`);
-        } else {
-          log.keyValue("Count", `${workspaces.length}`);
-          workspaces.forEach((ws) => {
-            const statusColor = ws.status === "running" ? chalk.green : chalk.dim;
-            console.log(`    ${statusColor("●")} ${ws.id} (${ws.repo || ws.id}) — ${statusColor(ws.status)}`);
-          });
-        }
-      } catch {
-        log.dim("  Could not fetch workspaces.");
+        log.error(err.message);
+        process.exit(1);
       }
-
-      // Config info
-      log.header("Configuration");
-      log.keyValue("API URL", getConfigValue("apiUrl") || "https://cheri.heysalad.app");
-      log.keyValue("Config dir", chalk.dim("~/.cheri/"));
-
-      log.blank();
     });
 }

package/src/commands/usage.js

@@ -0,0 +1,64 @@
+import chalk from "chalk";
+import ora from "ora";
+import { apiClient } from "../lib/api-client.js";
+import { log } from "../lib/logger.js";
+
+export async function showUsage() {
+  log.blank();
+  log.brand("Usage");
+
+  const spinner = ora("Fetching usage data...").start();
+
+  try {
+    const data = await apiClient.getUsage();
+    spinner.stop();
+
+    // Rate limit
+    log.header("Rate Limit");
+    log.keyValue("Plan", data.plan === "pro" ? chalk.green("Pro") : "Free");
+    log.keyValue("Limit", `${data.rateLimit.limit} requests/hour`);
+    const remaining = data.rateLimit.remaining;
+    const limit = data.rateLimit.limit;
+    const remainColor = remaining > limit * 0.5 ? chalk.green : remaining > limit * 0.1 ? chalk.yellow : chalk.red;
+    log.keyValue("Remaining", remainColor(`${remaining}`));
+    log.keyValue("Resets at", data.rateLimit.resetsAt);
+
+    // Today's usage
+    log.header("Today");
+    log.keyValue("Requests", `${data.usage.today.requests}`);
+    const endpoints = data.usage.today.endpoints || {};
+    if (Object.keys(endpoints).length > 0) {
+      for (const [ep, count] of Object.entries(endpoints)) {
+        console.log(`    ${chalk.dim(ep)} ${chalk.cyan(count)}`);
+      }
+    }
+
+    // Summary
+    log.header("Summary");
+    log.keyValue("Last 7 days", `${data.usage.last7d.requests} requests`);
+    log.keyValue("Last 30 days", `${data.usage.last30d.requests} requests`);
+    log.keyValue("All time", `${data.summary.totalRequests} requests`);
+    if (data.summary.memberSince) {
+      log.keyValue("Member since", new Date(data.summary.memberSince).toLocaleDateString());
+    }
+  } catch (err) {
+    spinner.stop();
+    log.error(err.message);
+  }
+
+  log.blank();
+}
+
+export function registerUsageCommand(program) {
+  program
+    .command("usage")
+    .description("Show API usage and rate limit status")
+    .action(async () => {
+      try {
+        await showUsage();
+      } catch (err) {
+        log.error(err.message);
+        process.exit(1);
+      }
+    });
+}

package/src/commands/workspace.js

@@ -3,6 +3,105 @@ import ora from "ora";
 import { apiClient } from "../lib/api-client.js";
 import { log } from "../lib/logger.js";
 
+export async function launchWorkspace(repo) {
+  log.blank();
+  log.brand("Launching workspace");
+  log.blank();
+
+  const spinner = ora("Creating workspace...").start();
+
+  try {
+    const { workspace: ws } = await apiClient.createWorkspace(repo);
+    spinner.succeed("Workspace is live!");
+
+    log.blank();
+    log.keyValue("ID", chalk.cyan(ws.id));
+    log.keyValue("Repo", chalk.cyan(ws.repo));
+    log.keyValue("Status", chalk.green(ws.status));
+    log.keyValue("URL", chalk.cyan.underline(ws.url));
+    log.blank();
+    log.dim("Open the URL above in your browser to start coding.");
+    log.blank();
+  } catch (err) {
+    spinner.fail("Failed to launch workspace");
+    throw err;
+  }
+}
+
+export async function stopWorkspace(id) {
+  const spinner = ora(`Stopping workspace: ${id}...`).start();
+
+  try {
+    await apiClient.deleteWorkspace(id);
+    spinner.succeed(`Workspace '${chalk.cyan(id)}' stopped.`);
+    log.dim("  Data preserved. Launch again to resume.");
+  } catch (err) {
+    spinner.fail("Failed to stop workspace");
+    throw err;
+  }
+}
+
+export async function listWorkspaces() {
+  const spinner = ora("Fetching workspaces...").start();
+
+  try {
+    const { workspaces } = await apiClient.listWorkspaces();
+    spinner.stop();
+
+    log.blank();
+    log.brand("Workspaces");
+    log.blank();
+
+    if (workspaces.length === 0) {
+      log.dim("  No workspaces found. Run 'cheri workspace launch owner/repo' to create one.");
+      log.blank();
+      return;
+    }
+
+    // Table header
+    console.log(
+      `  ${chalk.dim("ID".padEnd(24))} ${chalk.dim("REPO".padEnd(24))} ${chalk.dim("STATUS".padEnd(10))} ${chalk.dim("URL")}`
+    );
+    console.log(chalk.dim("  " + "─".repeat(90)));
+
+    workspaces.forEach((ws) => {
+      const statusIcon =
+        ws.status === "running" ? chalk.green("●") : chalk.dim("○");
+      const statusColor =
+        ws.status === "running" ? chalk.green : chalk.dim;
+      console.log(
+        `  ${ws.id.padEnd(24)} ${(ws.repo || "").padEnd(24)} ${statusIcon} ${statusColor(ws.status.padEnd(9))} ${chalk.cyan(ws.url || "")}`
+      );
+    });
+
+    log.blank();
+  } catch (err) {
+    spinner.fail("Failed to fetch workspaces");
+    throw err;
+  }
+}
+
+export async function getWorkspaceStatus(id) {
+  const spinner = ora("Fetching workspace status...").start();
+
+  try {
+    const { workspace: ws } = await apiClient.getWorkspaceStatus(id);
+    spinner.stop();
+
+    log.blank();
+    log.brand(`Workspace: ${ws.id}`);
+    log.blank();
+    log.keyValue("Status", ws.status === "running" ? chalk.green("● " + ws.status) : chalk.dim("○ " + ws.status));
+    log.keyValue("Repo", chalk.cyan(ws.repo || ""));
+    log.keyValue("URL", chalk.cyan.underline(ws.url || ""));
+    log.keyValue("Created", new Date(ws.createdAt).toLocaleString());
+    log.blank();
+  } catch (err) {
+    spinner.fail("Failed to fetch workspace status");
+    throw err;
+  }
+}
+
 export function registerWorkspaceCommand(program) {
   const workspace = program
     .command("workspace")
@@ -13,26 +112,9 @@ export function registerWorkspaceCommand(program) {
     .description("Launch a new cloud workspace")
     .argument("<repo>", "GitHub repository (owner/repo)")
     .action(async (repo) => {
-      log.blank();
-      log.brand("Launching workspace");
-      log.blank();
-
-      const spinner = ora("Creating workspace...").start();
-
       try {
-        const { workspace: ws } = await apiClient.createWorkspace(repo);
-        spinner.succeed("Workspace is live!");
-
-        log.blank();
-        log.keyValue("ID", chalk.cyan(ws.id));
-        log.keyValue("Repo", chalk.cyan(ws.repo));
-        log.keyValue("Status", chalk.green(ws.status));
-        log.keyValue("URL", chalk.cyan.underline(ws.url));
-        log.blank();
-        log.dim("Open the URL above in your browser to start coding.");
-        log.blank();
+        await launchWorkspace(repo);
       } catch (err) {
-        spinner.fail("Failed to launch workspace");
         log.error(err.message);
         process.exit(1);
       }
@@ -43,14 +125,9 @@ export function registerWorkspaceCommand(program) {
     .description("Stop a running workspace")
     .argument("<id>", "Workspace ID")
     .action(async (id) => {
-      const spinner = ora(`Stopping workspace: ${id}...`).start();
-
       try {
-        await apiClient.deleteWorkspace(id);
-        spinner.succeed(`Workspace '${chalk.cyan(id)}' stopped.`);
-        log.dim("  Data preserved. Launch again to resume.");
+        await stopWorkspace(id);
       } catch (err) {
-        spinner.fail("Failed to stop workspace");
         log.error(err.message);
         process.exit(1);
       }
@@ -60,39 +137,9 @@ export function registerWorkspaceCommand(program) {
     .command("list")
     .description("List all workspaces")
     .action(async () => {
-      const spinner = ora("Fetching workspaces...").start();
-
       try {
-        const { workspaces } = await apiClient.listWorkspaces();
-        spinner.stop();
-
-        log.blank();
-        log.brand("Workspaces");
-        log.blank();
-
-        if (workspaces.length === 0) {
-          log.dim("  No workspaces found. Run 'cheri workspace launch owner/repo' to create one.");
-          log.blank();
-          return;
-        }
-
-        // Table header
-        console.log(
-          `  ${chalk.dim("ID".padEnd(24))} ${chalk.dim("REPO".padEnd(24))} ${chalk.dim("STATUS".padEnd(10))} ${chalk.dim("URL")}`
-        );
-        console.log(chalk.dim("  " + "-".repeat(90)));
-
-        workspaces.forEach((ws) => {
-          const statusColor =
-            ws.status === "running" ? chalk.green : chalk.dim;
-          console.log(
-            `  ${ws.id.padEnd(24)} ${(ws.repo || "").padEnd(24)} ${statusColor(ws.status.padEnd(10))} ${chalk.cyan(ws.url || "")}`
-          );
-        });
-
-        log.blank();
+        await listWorkspaces();
       } catch (err) {
-        spinner.fail("Failed to fetch workspaces");
         log.error(err.message);
         process.exit(1);
       }
@@ -103,22 +150,9 @@ export function registerWorkspaceCommand(program) {
     .description("Get workspace status")
     .argument("<id>", "Workspace ID")
     .action(async (id) => {
-      const spinner = ora("Fetching workspace status...").start();
-
       try {
-        const { workspace: ws } = await apiClient.getWorkspaceStatus(id);
-        spinner.stop();
-
-        log.blank();
-        log.brand(`Workspace: ${ws.id}`);
-        log.blank();
-        log.keyValue("Status", ws.status === "running" ? chalk.green(ws.status) : chalk.dim(ws.status));
-        log.keyValue("Repo", chalk.cyan(ws.repo || ""));
-        log.keyValue("URL", chalk.cyan.underline(ws.url || ""));
-        log.keyValue("Created", new Date(ws.createdAt).toLocaleString());
-        log.blank();
+        await getWorkspaceStatus(id);
       } catch (err) {
-        spinner.fail("Failed to fetch workspace status");
         log.error(err.message);
         process.exit(1);
       }

package/src/lib/api-client.js

@@ -83,4 +83,9 @@ export const apiClient = {
   async clearMemory() {
     return request("/api/memory", { method: "DELETE" });
   },
+
+  // Usage
+  async getUsage() {
+    return request("/api/usage");
+  },
 };

package/src/lib/config-store.js

@@ -74,15 +74,5 @@ function getDefaultConfig() {
       theme: "dark",
       fontSize: 14,
     },
-    ai: {
-      provider: "anthropic",
-      model: "",
-      keys: {
-        anthropic: "",
-        openai: "",
-        deepseek: "",
-        gemini: "",
-      },
-    },
   };
 }

package/src/lib/logger.js

@@ -36,4 +36,14 @@ export const log = {
       console.log(chalk.dim(prefix) + " " + item);
     });
   },
+  banner(version = "0.1.0") {
+    console.log();
+    console.log(`   ${chalk.red("🍒")} ${chalk.red.bold("Cheri")}`);
+    console.log(`   ${chalk.dim("AI-powered cloud IDE by HeySalad")}`);
+    console.log(`   ${chalk.dim("v" + version)}`);
+    console.log();
+  },
+  tip(msg) {
+    console.log(`  ${chalk.blue("tip")}  ${chalk.dim(msg)}`);
+  },
 };