@heysalad/cheri-cli 0.2.0 → 0.3.1

package/README.md

@@ -1,6 +1,8 @@
-# Cheri CLI
+# cheri-cli
 
-AI-powered cloud IDE by [HeySalad](https://heysalad.app). Like Claude Code, but for cloud workspaces.
+CLI for [Cheri](https://cheri.heysalad.app) — the AI-powered cloud IDE that never forgets.
+
+Manage workspaces, track API usage, and access your AI memory from the terminal.
 
 ## Install
 
@@ -8,53 +10,79 @@ AI-powered cloud IDE by [HeySalad](https://heysalad.app). Like Claude Code, but
 npm install -g @heysalad/cheri-cli
 ```
 
-## Usage
+Requires Node.js 18+.
+
+## Quick Start
 
 ```bash
-# Login to your Cheri account
+# Authenticate with your Cheri account
 cheri login
 
+# Launch a cloud workspace
+cheri workspace launch owner/my-repo
+
 # Check account status
 cheri status
 
-# Launch a cloud workspace
-cheri workspace launch owner/repo
-
-# List your workspaces
-cheri workspace list
+# View API usage and rate limits
+cheri usage
+```
 
-# Stop a workspace
-cheri workspace stop
+## Commands
+
+| Command | Description |
+|---|---|
+| `cheri login` | Authenticate with GitHub |
+| `cheri status` | Show account and workspace status |
+| `cheri usage` | Show API usage and rate limit status |
+| `cheri workspace launch <repo>` | Launch a new cloud workspace |
+| `cheri workspace list` | List all workspaces |
+| `cheri workspace stop <id>` | Stop a running workspace |
+| `cheri workspace status <id>` | Get workspace status |
+| `cheri memory show` | Show current memory entries |
+| `cheri memory add <text>` | Add a memory entry |
+| `cheri memory clear` | Clear all memory |
+| `cheri memory export` | Export memory to JSON |
+| `cheri config list` | Show all configuration |
+| `cheri config get <key>` | Get a config value |
+| `cheri config set <key> <value>` | Set a config value |
+| `cheri init` | Initialize a project |
+
+## Interactive REPL
+
+Run `cheri` with no arguments to enter the interactive REPL:
 
-# Initialize AI project config
-cheri init
+```
+$ cheri
+🍒 cheri > help
+🍒 cheri > workspace list
+🍒 cheri > usage
+🍒 cheri > exit
+```
 
-# Manage persistent memory
-cheri memory show
-cheri memory add "Always use TypeScript strict mode"
-cheri memory clear
+## Rate Limits
 
-# View/update configuration
-cheri config list
-cheri config set apiUrl https://cheri.heysalad.app
-```
+| Plan | Limit |
+|---|---|
+| Free | 100 requests/hour |
+| Pro | 1,000 requests/hour |
 
-## How it works
+Use `cheri usage` to check your current rate limit status.
 
-1. **`cheri login`** opens your browser for GitHub OAuth, then you paste your API token
-2. **`cheri workspace launch`** spins up a cloud workspace with code-server (VS Code in browser)
-3. **`cheri memory`** stores persistent context that follows you across sessions
-4. **`cheri init`** creates a local `.ai/` directory with project constitution files
+## Configuration
 
-## Requirements
+Config is stored in `~/.cheri/`. Set the API URL if self-hosting:
 
-- Node.js >= 18
+```bash
+cheri config set apiUrl https://your-instance.example.com
+```
 
 ## Links
 
 - [Cheri Cloud IDE](https://cheri.heysalad.app)
-- [GitHub](https://github.com/Hey-Salad/cheri-cli)
+- [Dashboard](https://cheri.heysalad.app/dashboard)
+- [GitHub](https://github.com/chilu18/cloud-ide)
 
 ## License
 
-MIT - HeySalad
+MIT

package/bin/cheri.js

@@ -7,12 +7,12 @@ import { registerStatusCommand } from "../src/commands/status.js";
 import { registerMemoryCommand } from "../src/commands/memory.js";
 import { registerConfigCommand } from "../src/commands/config.js";
 import { registerWorkspaceCommand } from "../src/commands/workspace.js";
-import { registerChatCommand } from "../src/commands/chat.js";
+import { registerUsageCommand } from "../src/commands/usage.js";
 
 program
   .name("cheri")
   .description("Cheri CLI - AI-powered cloud IDE by HeySalad")
-  .version("0.2.0");
+  .version("0.1.0");
 
 registerLoginCommand(program);
 registerInitCommand(program);
@@ -20,12 +20,12 @@ registerStatusCommand(program);
 registerMemoryCommand(program);
 registerConfigCommand(program);
 registerWorkspaceCommand(program);
-registerChatCommand(program);
+registerUsageCommand(program);
 
-// If no args, launch interactive REPL
+// If no args, launch interactive command REPL
 if (!process.argv.slice(2).length) {
-  const { startRepl } = await import("../src/lib/repl.js");
-  await startRepl();
+  const { startCommandRepl } = await import("../src/repl.js");
+  await startCommandRepl();
 } else {
   program.parse(process.argv);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heysalad/cheri-cli",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Cheri CLI - AI-powered cloud IDE by HeySalad. Like Claude Code, but for cloud workspaces.",
   "type": "module",
   "bin": {
@@ -8,15 +8,14 @@
   },
   "files": [
     "bin/",
-    "src/",
-    "README.md"
+    "src/"
   ],
   "scripts": {
     "start": "node bin/cheri.js",
     "dev": "node bin/cheri.js",
-    "release:patch": "npm version patch && npm publish --access public && git push && git push --tags",
-    "release:minor": "npm version minor && npm publish --access public && git push && git push --tags",
-    "release:major": "npm version major && npm publish --access public && git push && git push --tags"
+    "release:patch": "npm version patch && npm publish && git push && git push --tags",
+    "release:minor": "npm version minor && npm publish && git push && git push --tags",
+    "release:major": "npm version major && npm publish && git push && git push --tags"
   },
   "keywords": [
     "cloud-ide",
@@ -29,23 +28,18 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Hey-Salad/cheri-cli.git"
+    "url": "https://github.com/chilu18/cloud-ide.git",
+    "directory": "cli"
   },
-  "homepage": "https://cheri.heysalad.app",
   "author": "HeySalad",
   "license": "MIT",
   "engines": {
     "node": ">=18"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.74.0",
-    "@google/generative-ai": "^0.24.1",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "inquirer": "^9.2.23",
-    "marked": "^15.0.12",
-    "marked-terminal": "^7.3.0",
-    "openai": "^6.22.0",
     "ora": "^8.0.1"
   }
 }

package/src/commands/config.js

@@ -2,6 +2,42 @@ import chalk from "chalk";
 import { getConfig, getConfigValue, setConfigValue } from "../lib/config-store.js";
 import { log } from "../lib/logger.js";
 
+export function listConfig() {
+  const cfg = getConfig();
+
+  log.blank();
+  log.brand("Configuration");
+  log.blank();
+
+  printObject(cfg, "");
+  log.blank();
+}
+
+export function getConfigKey(key) {
+  const value = getConfigValue(key);
+  if (value === undefined) {
+    throw new Error(`Key '${key}' not found.`);
+  }
+  if (typeof value === "object") {
+    console.log(JSON.stringify(value, null, 2));
+  } else {
+    console.log(value);
+  }
+}
+
+export function setConfigKey(key, value) {
+  // Try to parse as JSON (for arrays, numbers, booleans)
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch {
+    parsed = value;
+  }
+
+  setConfigValue(key, parsed);
+  log.success(`Set ${chalk.cyan(key)} = ${chalk.white(value)}`);
+}
+
 export function registerConfigCommand(program) {
   const config = program
     .command("config")
@@ -11,46 +47,26 @@ export function registerConfigCommand(program) {
     .command("list")
     .description("Show all configuration values")
     .action(() => {
-      const cfg = getConfig();
-
-      log.blank();
-      log.brand("Configuration");
-      log.blank();
-
-      printObject(cfg, "");
-      log.blank();
+      listConfig();
     });
 
   config
     .command("get <key>")
     .description("Get a configuration value")
     .action((key) => {
-      const value = getConfigValue(key);
-      if (value === undefined) {
-        log.error(`Key '${key}' not found.`);
+      try {
+        getConfigKey(key);
+      } catch (err) {
+        log.error(err.message);
         process.exit(1);
       }
-      if (typeof value === "object") {
-        console.log(JSON.stringify(value, null, 2));
-      } else {
-        console.log(value);
-      }
     });
 
   config
     .command("set <key> <value>")
     .description("Set a configuration value")
     .action((key, value) => {
-      // Try to parse as JSON (for arrays, numbers, booleans)
-      let parsed;
-      try {
-        parsed = JSON.parse(value);
-      } catch {
-        parsed = value;
-      }
-
-      setConfigValue(key, parsed);
-      log.success(`Set ${chalk.cyan(key)} = ${chalk.white(value)}`);
+      setConfigKey(key, value);
     });
 }
 

package/src/commands/init.js

@@ -1,7 +1,7 @@
 import ora from "ora";
 import inquirer from "inquirer";
 import chalk from "chalk";
-import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from "fs";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
 import { join } from "path";
 import { setConfigValue } from "../lib/config-store.js";
 import { log } from "../lib/logger.js";
@@ -79,6 +79,86 @@ const TEMPLATES = {
 `,
 };
 
+export async function initProject(options = {}) {
+  log.blank();
+  log.brand("Initializing project...");
+  log.blank();
+
+  const aiDir = join(process.cwd(), AI_DIR);
+
+  if (existsSync(aiDir) && !options.yes) {
+    const { overwrite } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "overwrite",
+        message: "A .ai/ directory already exists. Add missing files?",
+        default: true,
+      },
+    ]);
+    if (!overwrite) {
+      log.info("Initialization cancelled.");
+      return;
+    }
+  }
+
+  let projectName = options.name;
+  if (!projectName && !options.yes) {
+    const answers = await inquirer.prompt([
+      {
+        type: "input",
+        name: "name",
+        message: "Project name:",
+        default: process.cwd().split("/").pop(),
+      },
+    ]);
+    projectName = answers.name;
+  }
+
+  projectName = projectName || process.cwd().split("/").pop();
+
+  const spinner = ora("Creating project constitution...").start();
+
+  try {
+    if (!existsSync(aiDir)) {
+      mkdirSync(aiDir, { recursive: true });
+    }
+
+    const created = [];
+    for (const [filename, content] of Object.entries(TEMPLATES)) {
+      const filePath = join(aiDir, filename);
+      if (!existsSync(filePath)) {
+        writeFileSync(filePath, content);
+        created.push(filename);
+      }
+    }
+
+    spinner.succeed("Project constitution created");
+    log.blank();
+
+    if (created.length > 0) {
+      created.forEach((file) => {
+        console.log(`  ${chalk.green("+")} .ai/${file}`);
+      });
+    } else {
+      log.info("All constitution files already exist.");
+    }
+
+    // Save project config
+    setConfigValue("project.name", projectName);
+    setConfigValue("project.initializedAt", new Date().toISOString());
+
+    log.blank();
+    log.success(`Project '${chalk.bold(projectName)}' initialized.`);
+    log.dim(
+      `Run ${chalk.cyan("cheri workspace launch owner/repo")} to start coding in the cloud.`
+    );
+    log.blank();
+  } catch (err) {
+    spinner.fail("Failed to initialize project");
+    throw err;
+  }
+}
+
 export function registerInitCommand(program) {
   program
     .command("init")
@@ -86,81 +166,9 @@ export function registerInitCommand(program) {
     .option("-n, --name <name>", "Project name")
     .option("-y, --yes", "Skip prompts and use defaults")
     .action(async (options) => {
-      log.blank();
-      log.brand("Initializing project...");
-      log.blank();
-
-      const aiDir = join(process.cwd(), AI_DIR);
-
-      if (existsSync(aiDir) && !options.yes) {
-        const { overwrite } = await inquirer.prompt([
-          {
-            type: "confirm",
-            name: "overwrite",
-            message: "A .ai/ directory already exists. Add missing files?",
-            default: true,
-          },
-        ]);
-        if (!overwrite) {
-          log.info("Initialization cancelled.");
-          return;
-        }
-      }
-
-      let projectName = options.name;
-      if (!projectName && !options.yes) {
-        const answers = await inquirer.prompt([
-          {
-            type: "input",
-            name: "name",
-            message: "Project name:",
-            default: process.cwd().split("/").pop(),
-          },
-        ]);
-        projectName = answers.name;
-      }
-
-      projectName = projectName || process.cwd().split("/").pop();
-
-      const spinner = ora("Creating project constitution...").start();
-
       try {
-        if (!existsSync(aiDir)) {
-          mkdirSync(aiDir, { recursive: true });
-        }
-
-        const created = [];
-        for (const [filename, content] of Object.entries(TEMPLATES)) {
-          const filePath = join(aiDir, filename);
-          if (!existsSync(filePath)) {
-            writeFileSync(filePath, content);
-            created.push(filename);
-          }
-        }
-
-        spinner.succeed("Project constitution created");
-        log.blank();
-
-        if (created.length > 0) {
-          created.forEach((file) => {
-            console.log(`  ${chalk.green("+")} .ai/${file}`);
-          });
-        } else {
-          log.info("All constitution files already exist.");
-        }
-
-        // Save project config
-        setConfigValue("project.name", projectName);
-        setConfigValue("project.initializedAt", new Date().toISOString());
-
-        log.blank();
-        log.success(`Project '${chalk.bold(projectName)}' initialized.`);
-        log.dim(
-          `Run ${chalk.cyan("cheri workspace launch owner/repo")} to start coding in the cloud.`
-        );
-        log.blank();
+        await initProject(options);
       } catch (err) {
-        spinner.fail("Failed to initialize project");
         log.error(err.message);
         process.exit(1);
       }

package/src/commands/login.js

@@ -4,53 +4,60 @@ import { setConfigValue, getConfigValue } from "../lib/config-store.js";
 import { apiClient } from "../lib/api-client.js";
 import { log } from "../lib/logger.js";
 
+export async function loginFlow() {
+  const apiUrl = getConfigValue("apiUrl") || "https://cheri.heysalad.app";
+
+  log.blank();
+  log.brand("Login to Cheri");
+  log.blank();
+
+  log.info("Step 1: Open this URL in your browser to authenticate:");
+  log.blank();
+  console.log(`  ${chalk.cyan.underline(`${apiUrl}/auth/github`)}`);
+  log.blank();
+  log.info("Step 2: After login, visit the token page:");
+  console.log(`  ${chalk.cyan.underline(`${apiUrl}/auth/token?user=YOUR_USERNAME`)}`);
+  log.blank();
+  log.info("Step 3: Copy your API token and paste it below.");
+  log.blank();
+
+  const { token } = await inquirer.prompt([
+    {
+      type: "password",
+      name: "token",
+      message: "Paste your API token:",
+      mask: "*",
+    },
+  ]);
+
+  if (!token || !token.trim()) {
+    throw new Error("No token provided.");
+  }
+
+  setConfigValue("token", token.trim());
+
+  // Verify token works
+  try {
+    const me = await apiClient.getMe();
+    log.blank();
+    log.success(`Logged in as ${chalk.cyan(me.ghLogin || me.userId)}`);
+    log.keyValue("Plan", me.plan === "pro" ? chalk.green("Pro") : "Free");
+    log.blank();
+  } catch (err) {
+    setConfigValue("token", "");
+    throw new Error(`Token verification failed: ${err.message}`);
+  }
+}
+
 export function registerLoginCommand(program) {
   program
     .command("login")
     .description("Authenticate with Cheri cloud IDE")
     .action(async () => {
-      const apiUrl = getConfigValue("apiUrl") || "https://cheri.heysalad.app";
-
-      log.blank();
-      log.brand("Login to Cheri");
-      log.blank();
-
-      log.info("Step 1: Open this URL in your browser to authenticate:");
-      log.blank();
-      console.log(`  ${chalk.cyan.underline(`${apiUrl}/auth/github`)}`);
-      log.blank();
-      log.info("Step 2: After login, visit the token page:");
-      console.log(`  ${chalk.cyan.underline(`${apiUrl}/auth/token?user=YOUR_USERNAME`)}`);
-      log.blank();
-      log.info("Step 3: Copy your API token and paste it below.");
-      log.blank();
-
-      const { token } = await inquirer.prompt([
-        {
-          type: "password",
-          name: "token",
-          message: "Paste your API token:",
-          mask: "*",
-        },
-      ]);
-
-      if (!token || !token.trim()) {
-        log.error("No token provided.");
-        process.exit(1);
-      }
-
-      setConfigValue("token", token.trim());
-
-      // Verify token works
       try {
-        const me = await apiClient.getMe();
-        log.blank();
-        log.success(`Logged in as ${chalk.cyan(me.ghLogin || me.userId)}`);
-        log.keyValue("Plan", me.plan === "pro" ? chalk.green("Pro") : "Free");
-        log.blank();
+        await loginFlow();
       } catch (err) {
-        log.error(`Token verification failed: ${err.message}`);
-        setConfigValue("token", "");
+        log.error(err.message);
         process.exit(1);
       }
     });