@heysalad/cheri-cli 0.4.0 → 0.6.0

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,13 +7,13 @@ 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";
 import { registerAgentCommand } from "../src/commands/agent.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);
@@ -21,7 +21,7 @@ registerStatusCommand(program);
 registerMemoryCommand(program);
 registerConfigCommand(program);
 registerWorkspaceCommand(program);
-registerChatCommand(program);
+registerUsageCommand(program);
 registerAgentCommand(program);
 
 // If no args, launch interactive command REPL

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heysalad/cheri-cli",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "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/agent.js

@@ -1,6 +1,4 @@
 import { apiClient } from "../lib/api-client.js";
-import { getConfigValue, setConfigValue } from "../lib/config-store.js";
-import { streamChatCompletion } from "../lib/deepseek-client.js";
 import { log } from "../lib/logger.js";
 import chalk from "chalk";
 
@@ -30,9 +28,7 @@ const TOOLS = [
       description: "Launch a new cloud workspace for a GitHub repository",
       parameters: {
         type: "object",
-        properties: {
-          repo: { type: "string", description: "GitHub repo in owner/name format" },
-        },
+        properties: { repo: { type: "string", description: "GitHub repo in owner/name format" } },
         required: ["repo"],
       },
     },
@@ -44,9 +40,7 @@ const TOOLS = [
       description: "Stop and delete a running workspace",
       parameters: {
         type: "object",
-        properties: {
-          id: { type: "string", description: "Workspace ID to stop" },
-        },
+        properties: { id: { type: "string", description: "Workspace ID to stop" } },
         required: ["id"],
       },
     },
@@ -58,9 +52,7 @@ const TOOLS = [
       description: "Get the status of a specific workspace",
       parameters: {
         type: "object",
-        properties: {
-          id: { type: "string", description: "Workspace ID" },
-        },
+        properties: { id: { type: "string", description: "Workspace ID" } },
         required: ["id"],
       },
     },
@@ -111,9 +103,7 @@ const TOOLS = [
       description: "Get a configuration value by key (dot notation supported)",
       parameters: {
         type: "object",
-        properties: {
-          key: { type: "string", description: "Config key, e.g. 'ai.provider'" },
-        },
+        properties: { key: { type: "string", description: "Config key, e.g. 'ai.provider'" } },
         required: ["key"],
       },
     },
@@ -156,11 +146,15 @@ async function executeTool(name, args) {
         return await apiClient.clearMemory();
       case "get_usage":
         return await apiClient.getUsage();
-      case "get_config":
+      case "get_config": {
+        const { getConfigValue } = await import("../lib/config-store.js");
         return { key: args.key, value: getConfigValue(args.key) };
-      case "set_config":
+      }
+      case "set_config": {
+        const { setConfigValue } = await import("../lib/config-store.js");
         setConfigValue(args.key, args.value);
         return { key: args.key, value: args.value, status: "updated" };
+      }
       default:
         return { error: `Unknown tool: ${name}` };
     }
@@ -169,6 +163,36 @@ async function executeTool(name, args) {
   }
 }
 
+// Parse SSE stream from the cloud proxy
+async function* parseSSEStream(response) {
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          const data = line.slice(6).trim();
+          if (data === "[DONE]") return;
+          try {
+            yield JSON.parse(data);
+          } catch {}
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
 export async function runAgent(userRequest) {
   const messages = [
     { role: "system", content: SYSTEM_PROMPT },
@@ -178,77 +202,73 @@ export async function runAgent(userRequest) {
   const MAX_ITERATIONS = 10;
 
   for (let i = 0; i < MAX_ITERATIONS; i++) {
-    let textContent = "";
+    const response = await apiClient.chatStream(messages, TOOLS);
+
+    let fullText = "";
     const toolCalls = {};
 
-    for await (const chunk of streamChatCompletion(messages, TOOLS)) {
+    for await (const chunk of parseSSEStream(response)) {
       const delta = chunk.choices?.[0]?.delta;
-      if (!delta) continue;
+      const finishReason = chunk.choices?.[0]?.finish_reason;
 
-      // Stream text content to stdout
-      if (delta.content) {
+      if (delta?.content) {
         process.stdout.write(delta.content);
-        textContent += delta.content;
+        fullText += delta.content;
       }
 
-      // Accumulate tool call deltas
-      if (delta.tool_calls) {
+      if (delta?.tool_calls) {
         for (const tc of delta.tool_calls) {
           const idx = tc.index;
           if (!toolCalls[idx]) {
-            toolCalls[idx] = { id: tc.id || "", function: { name: "", arguments: "" } };
+            toolCalls[idx] = { id: tc.id || "", name: "", arguments: "" };
           }
           if (tc.id) toolCalls[idx].id = tc.id;
-          if (tc.function?.name) toolCalls[idx].function.name += tc.function.name;
-          if (tc.function?.arguments) toolCalls[idx].function.arguments += tc.function.arguments;
+          if (tc.function?.name) toolCalls[idx].name = tc.function.name;
+          if (tc.function?.arguments) toolCalls[idx].arguments += tc.function.arguments;
         }
       }
+
+      if (finishReason) break;
     }
 
     const toolCallList = Object.values(toolCalls);
 
     // No tool calls — final text response, done
     if (toolCallList.length === 0) {
-      if (textContent) process.stdout.write("\n");
+      if (fullText) process.stdout.write("\n");
       return;
     }
 
-    // Append assistant message with tool calls
-    const assistantMsg = { role: "assistant", content: textContent || null, tool_calls: [] };
-    for (const tc of toolCallList) {
-      assistantMsg.tool_calls.push({
-        id: tc.id,
-        type: "function",
-        function: { name: tc.function.name, arguments: tc.function.arguments },
-      });
-    }
+    if (fullText) process.stdout.write("\n");
+
+    // Build assistant message with tool calls
+    const assistantMsg = { role: "assistant", content: fullText || null };
+    assistantMsg.tool_calls = toolCallList.map((tc) => ({
+      id: tc.id,
+      type: "function",
+      function: { name: tc.name, arguments: tc.arguments },
+    }));
     messages.push(assistantMsg);
 
-    // Execute each tool call and append results
+    // Execute each tool and add results
     for (const tc of toolCallList) {
-      const fnName = tc.function.name;
-      let args = {};
-      try {
-        args = JSON.parse(tc.function.arguments || "{}");
-      } catch {
-        args = {};
-      }
+      let input = {};
+      try { input = JSON.parse(tc.arguments); } catch {}
 
-      log.info(`Calling ${chalk.cyan(fnName)}${Object.keys(args).length ? chalk.dim(" " + JSON.stringify(args)) : ""}`);
+      log.info(`Calling ${chalk.cyan(tc.name)}${Object.keys(input).length ? chalk.dim(" " + JSON.stringify(input)) : ""}`);
 
-      const result = await executeTool(fnName, args);
-      const resultStr = JSON.stringify(result);
+      const result = await executeTool(tc.name, input);
 
       if (result.error) {
         log.error(result.error);
       } else {
-        log.success(fnName);
+        log.success(tc.name);
       }
 
       messages.push({
         role: "tool",
         tool_call_id: tc.id,
-        content: resultStr,
+        content: JSON.stringify(result),
       });
     }
   }

package/src/commands/memory.js

@@ -53,21 +53,13 @@ export async function showMemory(options = {}) {
 }
 
 export async function addMemory(content, category = "general") {
-  try {
-    const { entry, count } = await apiClient.addMemory(content, category);
-    log.success(`Memory saved (${count} total). Category: ${chalk.cyan(entry.category)}`);
-  } catch (err) {
-    throw err;
-  }
+  const { entry, count } = await apiClient.addMemory(content, category);
+  log.success(`Memory saved (${count} total). Category: ${chalk.cyan(entry.category)}`);
 }
 
 export async function clearMemory() {
-  try {
-    await apiClient.clearMemory();
-    log.success("All memories cleared.");
-  } catch (err) {
-    throw err;
-  }
+  await apiClient.clearMemory();
+  log.success("All memories cleared.");
 }
 
 export async function exportMemory(options = {}) {

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/lib/api-client.js

@@ -88,4 +88,44 @@ export const apiClient = {
   async getUsage() {
     return request("/api/usage");
   },
+
+  // AI Chat (streaming)
+  async chatStream(messages, tools = [], options = {}) {
+    const baseUrl = getBaseUrl();
+    const token = getToken();
+
+    if (!token) {
+      throw new Error("Not logged in. Run 'cheri login' first.");
+    }
+
+    const body = {
+      messages,
+      stream: true,
+    };
+    if (tools.length > 0) body.tools = tools;
+    if (options.model) body.model = options.model;
+
+    const res = await fetch(`${baseUrl}/api/chat/completions`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) {
+      const text = await res.text();
+      let msg;
+      try { msg = JSON.parse(text).error || text; } catch { msg = text; }
+      throw new Error(`AI error (${res.status}): ${msg}`);
+    }
+
+    return res;
+  },
+
+  // AI Models
+  async getModels() {
+    return request("/api/chat/models");
+  },
 };

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,7 +36,7 @@ export const log = {
       console.log(chalk.dim(prefix) + " " + item);
     });
   },
-  banner(version = "0.2.0") {
+  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")}`);

package/src/repl.js

@@ -9,6 +9,7 @@ import { showStatus } from "./commands/status.js";
 import { listConfig, getConfigKey, setConfigKey } from "./commands/config.js";
 import { loginFlow } from "./commands/login.js";
 import { initProject } from "./commands/init.js";
+import { showUsage } from "./commands/usage.js";
 import { runAgent } from "./commands/agent.js";
 
 const COMMANDS = {
@@ -21,13 +22,13 @@ const COMMANDS = {
   "memory clear":     { args: "",       desc: "Clear all memory" },
   "memory export":    { args: "",       desc: "Export memory to JSON" },
   "status":           { args: "",       desc: "Show account & workspace status" },
+  "usage":            { args: "",       desc: "Show API usage & rate limits" },
   "config list":      { args: "",       desc: "Show all configuration" },
   "config get":       { args: "<key>",  desc: "Get a config value" },
   "config set":       { args: "<k> <v>",desc: "Set a config value" },
   "login":            { args: "",       desc: "Authenticate with Cheri" },
   "init":             { args: "",       desc: "Initialize a project" },
-  "chat":             { args: "",       desc: "Start AI coding session" },
-  "agent":            { args: "<request>", desc: "AI agent - natural language command" },
+  "agent":            { args: "<msg>",  desc: "AI agent — natural language commands" },
   "help":             { args: "",       desc: "Show this help" },
   "clear":            { args: "",       desc: "Clear the terminal" },
   "exit":             { args: "",       desc: "Exit Cheri" },
@@ -76,6 +77,10 @@ async function dispatch(input) {
       await showStatus();
       return;
 
+    case "usage":
+      await showUsage();
+      return;
+
     case "login":
       await loginFlow();
       return;
@@ -84,25 +89,6 @@ async function dispatch(input) {
       await initProject();
       return;
 
-    case "chat": {
-      const { startRepl: startChatRepl } = await import("./lib/repl.js");
-      await startChatRepl({
-        provider: sub || undefined,
-        model: rest || undefined,
-      });
-      return;
-    }
-
-    case "agent": {
-      const agentInput = parts.slice(1).join(" ");
-      if (!agentInput) {
-        log.error("Usage: agent <request>");
-        return;
-      }
-      await runAgent(agentInput);
-      return;
-    }
-
     case "workspace":
       switch (sub) {
         case "launch":
@@ -183,6 +169,16 @@ async function dispatch(input) {
           return;
       }
 
+    case "agent": {
+      const agentInput = parts.slice(1).join(" ");
+      if (!agentInput) {
+        log.error("Usage: agent <your request>");
+        return;
+      }
+      await runAgent(agentInput);
+      return;
+    }
+
     default:
       log.warn(`Unknown command: '${cmd}'. Type ${chalk.cyan("help")} for available commands.`);
   }
@@ -225,7 +221,7 @@ export async function startCommandRepl() {
     process.exit(0);
   });
 
-  // Handle Ctrl+C gracefully — don't crash, just exit
+  // Handle Ctrl+C gracefully
   rl.on("SIGINT", () => {
     console.log(chalk.dim("\nGoodbye! 🍒\n"));
     process.exit(0);

package/src/commands/chat.js

@@ -1,15 +0,0 @@
-import { startRepl } from "../lib/repl.js";
-
-export function registerChatCommand(program) {
-  program
-    .command("chat")
-    .description("Start an interactive AI coding session")
-    .option("-p, --provider <provider>", "AI provider (anthropic, openai, deepseek, gemini)")
-    .option("-m, --model <model>", "Model to use (overrides provider default)")
-    .action(async (options) => {
-      await startRepl({
-        provider: options.provider,
-        model: options.model,
-      });
-    });
-}