@inetafrica/open-claudia 1.9.2 → 1.10.0

package/.env.example

@@ -2,6 +2,7 @@ TELEGRAM_BOT_TOKEN=your-bot-token-from-botfather
 TELEGRAM_CHAT_ID=your-chat-id
 WORKSPACE=/path/to/your/workspace
 CLAUDE_PATH=/path/to/claude
+CURSOR_PATH=
 WHISPER_CLI=
 WHISPER_MODEL=
 FFMPEG=

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v1.10.0
+- Cursor Agent backend: switch between Claude Code and Cursor Agent CLI
+- New commands: /cursor, /claude, /backend with inline keyboard
+- Separate session persistence per backend (Claude and Cursor sessions don't clash)
+- Auto-discovers `agent` CLI in PATH if CURSOR_PATH not set
+- /status shows active backend
+
 ## v1.9.2
 - Fix: show what's new after upgrade
 - Startup message shows version

package/bot-agent.js

@@ -76,6 +76,17 @@ const CHAT_IDS = (config.TELEGRAM_CHAT_ID || "").split(",").map((s) => s.trim())
 const CHAT_ID = CHAT_IDS[0]; // Primary owner chat for crons/notifications
 const WORKSPACE = config.WORKSPACE;
 const CLAUDE_PATH = config.CLAUDE_PATH;
+const CURSOR_PATH = config.CURSOR_PATH || null;
+
+// Resolve Cursor Agent CLI (optional)
+let resolvedCursorPath = CURSOR_PATH;
+if (!resolvedCursorPath) {
+  try {
+    resolvedCursorPath = execSync("which agent 2>/dev/null", { encoding: "utf-8" }).trim() || null;
+  } catch (e) { resolvedCursorPath = null; }
+}
+if (resolvedCursorPath) console.log(`Cursor Agent CLI: ${resolvedCursorPath}`);
+
 const WHISPER_CLI = config.WHISPER_CLI || "";
 const WHISPER_MODEL = config.WHISPER_MODEL || "";
 const FFMPEG = config.FFMPEG || "";
@@ -88,6 +99,7 @@ const BOT_DIR = __dirname;
 // Detect PATH for subprocess
 const FULL_PATH = [
   path.dirname(CLAUDE_PATH),
+  resolvedCursorPath ? path.dirname(resolvedCursorPath) : null,
   path.dirname(process.execPath),
   FFMPEG ? path.dirname(FFMPEG) : null,
   WHISPER_CLI ? path.dirname(WHISPER_CLI) : null,
@@ -174,6 +186,9 @@ bot.setMyCommands([
   { command: "vault", description: "Manage credentials (password required)" },
   { command: "soul", description: "View/edit assistant identity" },
   { command: "status", description: "Session & settings info" },
+  { command: "cursor", description: "Switch to Cursor Agent backend" },
+  { command: "claude", description: "Switch to Claude Code backend" },
+  { command: "backend", description: "Show/switch active backend" },
   { command: "stop", description: "Cancel running task" },
   { command: "end", description: "End current session" },
   { command: "version", description: "Show current version" },
@@ -204,6 +219,7 @@ function saveState() {
   const data = {
     currentSession,
     lastSessionId,
+    cursorSessionId,
     settings,
   };
   try { fs.writeFileSync(STATE_FILE, JSON.stringify(data)); } catch (e) {}
@@ -276,6 +292,7 @@ let statusMessageId = null;
 let streamBuffer = "";
 let streamInterval = null;
 let lastSessionId = savedState.lastSessionId || null;
+let cursorSessionId = savedState.cursorSessionId || null;
 let messageQueue = [];            // Fallback queue (only used if chat process also fails)
 let activeCrons = new Map();
 let pendingVaultUnlock = false;
@@ -283,11 +300,12 @@ let pendingVaultAction = null;
 let isFirstMessage = !lastSessionId;
 
 let settings = savedState.settings || {
-  model: null, effort: null, budget: null, permissionMode: null, worktree: false,
+  model: null, effort: null, budget: null, permissionMode: null, worktree: false, backend: "claude",
 };
+if (!settings.backend) settings.backend = "claude";
 
 function resetSettings() {
-  settings = { model: null, effort: null, budget: null, permissionMode: null, worktree: false };
+  settings = { model: null, effort: null, budget: null, permissionMode: null, worktree: false, backend: "claude" };
 }
 
 function isAuthorized(msg) {
@@ -658,6 +676,7 @@ function parseStreamEvents(data) {
 }
 
 function buildClaudeArgs(prompt, opts = {}) {
+  if (settings.backend === "cursor") return buildCursorArgs(prompt, opts);
   const args = ["-p", "--verbose", "--output-format", "stream-json",
     "--append-system-prompt", buildSystemPrompt()];
   if (opts.continueSession) args.push("--continue");
@@ -672,6 +691,24 @@ function buildClaudeArgs(prompt, opts = {}) {
   return args;
 }
 
+function buildCursorArgs(prompt, opts = {}) {
+  const args = ["--print", "--trust", "--output-format", "stream-json"];
+  if (opts.continueSession) args.push("--continue");
+  else if (cursorSessionId && !opts.fresh) args.push("--resume", cursorSessionId);
+  if (settings.model) args.push("--model", settings.model);
+  args.push(prompt);
+  return args;
+}
+
+function getActiveBinary() {
+  if (settings.backend === "cursor") return resolvedCursorPath;
+  return CLAUDE_PATH;
+}
+
+function getActiveSessionId() {
+  return settings.backend === "cursor" ? cursorSessionId : lastSessionId;
+}
+
 /**
  * Quick chat process — handles messages while a heavy task is running.
  * Uses a fresh session (no --resume) with context about what's running.
@@ -747,7 +784,8 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
   let currentToolDetail = "";
 
   const args = buildClaudeArgs(prompt, opts);
-  const proc = spawn(CLAUDE_PATH, args, {
+  const binaryPath = getActiveBinary();
+  const proc = spawn(binaryPath, args, {
     cwd,
     env: { ...process.env, PATH: FULL_PATH, HOME: process.env.HOME },
     stdio: ["ignore", "pipe", "pipe"],
@@ -815,7 +853,11 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
           }
         }
       }
-      if (evt.type === "result" && evt.session_id) { lastSessionId = evt.session_id; saveState(); }
+      if (evt.type === "result" && evt.session_id) {
+        if (settings.backend === "cursor") { cursorSessionId = evt.session_id; }
+        else { lastSessionId = evt.session_id; }
+        saveState();
+      }
       if (evt.type === "result" && evt.result) assistantText = evt.result;
     }
   });
@@ -1094,10 +1136,38 @@ bot.onText(/\/budget$/, (msg) => {
 bot.onText(/\/budget (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const v = parseFloat(match[1].replace("$","")); settings.budget = v > 0 ? v : null; send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); });
 
 bot.onText(/\/plan$/, (msg) => { if (!isAuthorized(msg)) return; const p = settings.permissionMode === "plan"; settings.permissionMode = p ? null : "plan"; send(p ? "Plan mode off." : "Plan mode on."); });
-bot.onText(/\/compact/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; if (!lastSessionId) return send("No conversation."); await runClaude("Summarize: key decisions, code state, next steps.", currentSession.dir, msg.message_id); });
+bot.onText(/\/compact/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; if (!getActiveSessionId()) return send("No conversation."); await runClaude("Summarize: key decisions, code state, next steps.", currentSession.dir, msg.message_id); });
 bot.onText(/\/continue$/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; await runClaude("continue where we left off", currentSession.dir, msg.message_id, { continueSession: true }); });
 bot.onText(/\/worktree$/, (msg) => { if (!isAuthorized(msg)) return; settings.worktree = !settings.worktree; send(settings.worktree ? "Worktree on." : "Worktree off."); });
 
+bot.onText(/\/cursor$/, async (msg) => {
+  if (!isAuthorized(msg)) return;
+  if (!resolvedCursorPath) return send("Cursor Agent CLI not found.\nSet CURSOR_PATH in .env or install: https://docs.cursor.com/agent");
+  settings.backend = "cursor";
+  settings.model = null;
+  saveState();
+  const sid = cursorSessionId ? `\nSession: ${cursorSessionId.slice(0, 8)}...` : "\nNew session.";
+  send(`Switched to Cursor Agent.${sid}\n\n/claude — switch back`);
+});
+
+bot.onText(/\/claude$/, async (msg) => {
+  if (!isAuthorized(msg)) return;
+  settings.backend = "claude";
+  settings.model = null;
+  saveState();
+  const sid = lastSessionId ? `\nSession: ${lastSessionId.slice(0, 8)}...` : "\nNew session.";
+  send(`Switched to Claude Code.${sid}\n\n/cursor — switch to Cursor`);
+});
+
+bot.onText(/\/backend$/, async (msg) => {
+  if (!isAuthorized(msg)) return;
+  const label = settings.backend === "cursor" ? "Cursor Agent" : "Claude Code";
+  const cursorAvail = resolvedCursorPath ? "available" : "not found";
+  send(`Backend: ${label}\n\nClaude Code: available\nCursor Agent: ${cursorAvail}`, { keyboard: { inline_keyboard: [
+    [{ text: "Claude Code", callback_data: "be:claude" }, { text: "Cursor Agent", callback_data: "be:cursor" }],
+  ] } });
+});
+
 bot.onText(/\/mode$/, async (msg) => {
   if (!isAuthorized(msg)) return;
   await send("Bot mode: *agent* (non-blocking)\n\nHeavy tasks run in the background. You can keep chatting while they work.\nSwitch to direct mode for serial execution with shared session context.", {
@@ -1133,8 +1203,10 @@ bot.onText(/\/stop/, async (msg) => {
 bot.onText(/\/status/, (msg) => {
   if (!isAuthorized(msg)) return;
   if (!currentSession) return send("No session.", { keyboard: { inline_keyboard: [[{ text: "Pick", callback_data: "show:projects" }]] } });
+  const backendLabel = settings.backend === "cursor" ? "Cursor Agent" : "Claude Code";
   const lines = [
     `Project: ${currentSession.name} (agent mode)`,
+    `Backend: ${backendLabel}`,
     `Model: ${settings.model || "default"} | Effort: ${settings.effort || "default"}`,
     `Vault: ${vault.isUnlocked() ? "unlocked" : "locked"} | Crons: ${activeCrons.size}`,
   ];
@@ -1281,6 +1353,16 @@ bot.on("callback_query", async (q) => {
   if (d.startsWith("m:")) { settings.model = d.slice(2) === "default" ? null : d.slice(2); await send(`Model: ${settings.model || "default"}`); return; }
   if (d.startsWith("e:")) { const e = d.slice(2); settings.effort = e === "default" ? null : e; await send(`Effort: ${settings.effort || "default"}`); return; }
   if (d.startsWith("b:")) { const b = d.slice(2); settings.budget = b === "none" ? null : parseFloat(b); await send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); return; }
+  if (d.startsWith("be:")) {
+    const be = d.slice(3);
+    if (be === "cursor" && !resolvedCursorPath) { await send("Cursor Agent CLI not found."); return; }
+    settings.backend = be;
+    settings.model = null;
+    saveState();
+    const label = be === "cursor" ? "Cursor Agent" : "Claude Code";
+    await send(`Switched to ${label}.`);
+    return;
+  }
 
   // Mode switching
   if (d.startsWith("mode:")) {

package/bot.js

@@ -107,6 +107,7 @@ const CHAT_IDS = (config.TELEGRAM_CHAT_ID || "").split(",").map((s) => s.trim())
 const CHAT_ID = CHAT_IDS[0]; // Primary owner chat for crons/notifications
 const WORKSPACE = config.WORKSPACE;
 const CLAUDE_PATH = config.CLAUDE_PATH;
+const CURSOR_PATH = config.CURSOR_PATH || null;
 
 // Validate critical config at startup
 if (!TOKEN) { console.error("TELEGRAM_BOT_TOKEN not set"); process.exit(1); }
@@ -135,6 +136,15 @@ if (!fs.existsSync(CLAUDE_PATH)) {
     process.exit(1);
   }
 }
+
+// Resolve Cursor Agent CLI (optional — discovered at startup)
+let resolvedCursorPath = CURSOR_PATH;
+if (!resolvedCursorPath) {
+  try {
+    resolvedCursorPath = execSync("which agent 2>/dev/null", { encoding: "utf-8" }).trim() || null;
+  } catch (e) { resolvedCursorPath = null; }
+}
+if (resolvedCursorPath) console.log(`Cursor Agent CLI: ${resolvedCursorPath}`);
 const WHISPER_CLI = config.WHISPER_CLI || "";
 const WHISPER_MODEL = config.WHISPER_MODEL || "";
 const FFMPEG = config.FFMPEG || "";
@@ -147,6 +157,7 @@ const BOT_DIR = __dirname;
 // Detect PATH for subprocess
 const FULL_PATH = [
   path.dirname(CLAUDE_PATH),
+  resolvedCursorPath ? path.dirname(resolvedCursorPath) : null,
   path.dirname(process.execPath),
   FFMPEG ? path.dirname(FFMPEG) : null,
   WHISPER_CLI ? path.dirname(WHISPER_CLI) : null,
@@ -233,6 +244,9 @@ bot.setMyCommands([
   { command: "vault", description: "Manage credentials (password required)" },
   { command: "soul", description: "View/edit assistant identity" },
   { command: "status", description: "Session & settings info" },
+  { command: "cursor", description: "Switch to Cursor Agent backend" },
+  { command: "claude", description: "Switch to Claude Code backend" },
+  { command: "backend", description: "Show/switch active backend" },
   { command: "stop", description: "Cancel running task" },
   { command: "end", description: "End current session" },
   { command: "version", description: "Show current version" },
@@ -270,6 +284,7 @@ function saveState() {
   const data = {
     currentSession,
     lastSessionId,
+    cursorSessionId,
     settings,
   };
   try { fs.writeFileSync(STATE_FILE, JSON.stringify(data)); } catch (e) {}
@@ -338,6 +353,7 @@ let statusMessageId = null;
 let streamBuffer = "";
 let streamInterval = null;
 let lastSessionId = savedState.lastSessionId || null;
+let cursorSessionId = savedState.cursorSessionId || null;
 let messageQueue = [];
 let activeCrons = new Map();
 let pendingVaultUnlock = false; // Waiting for password
@@ -345,11 +361,12 @@ let pendingVaultAction = null;  // What to do after unlock
 let isFirstMessage = !lastSessionId; // Track if this is first message in session
 
 let settings = savedState.settings || {
-  model: null, effort: null, budget: null, permissionMode: null, worktree: false,
+  model: null, effort: null, budget: null, permissionMode: null, worktree: false, backend: "claude",
 };
+if (!settings.backend) settings.backend = "claude";
 
 function resetSettings() {
-  settings = { model: null, effort: null, budget: null, permissionMode: null, worktree: false };
+  settings = { model: null, effort: null, budget: null, permissionMode: null, worktree: false, backend: "claude" };
 }
 
 function isAuthorized(msg) {
@@ -720,6 +737,7 @@ function parseStreamEvents(data) {
 }
 
 function buildClaudeArgs(prompt, opts = {}) {
+  if (settings.backend === "cursor") return buildCursorArgs(prompt, opts);
   const args = ["-p", "--verbose", "--output-format", "stream-json",
     "--append-system-prompt", buildSystemPrompt()];
   if (opts.continueSession) args.push("--continue");
@@ -734,6 +752,24 @@ function buildClaudeArgs(prompt, opts = {}) {
   return args;
 }
 
+function buildCursorArgs(prompt, opts = {}) {
+  const args = ["--print", "--trust", "--output-format", "stream-json"];
+  if (opts.continueSession) args.push("--continue");
+  else if (cursorSessionId && !opts.fresh) args.push("--resume", cursorSessionId);
+  if (settings.model) args.push("--model", settings.model);
+  args.push(prompt);
+  return args;
+}
+
+function getActiveBinary() {
+  if (settings.backend === "cursor") return resolvedCursorPath;
+  return CLAUDE_PATH;
+}
+
+function getActiveSessionId() {
+  return settings.backend === "cursor" ? cursorSessionId : lastSessionId;
+}
+
 async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
   if (runningProcess) {
     messageQueue.push({ prompt, replyToMsgId, opts });
@@ -750,11 +786,12 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
   let currentToolDetail = "";
 
   const args = buildClaudeArgs(prompt, opts);
-  const proc = spawn(CLAUDE_PATH, args, {
+  const binaryPath = getActiveBinary();
+  const proc = spawn(binaryPath, args, {
     cwd,
     env: { ...process.env, PATH: FULL_PATH, HOME: process.env.HOME },
     stdio: ["ignore", "pipe", "pipe"],
-    detached: process.platform !== "win32", // Create process group so /stop kills children too
+    detached: process.platform !== "win32",
   });
 
   runningProcess = proc;
@@ -832,7 +869,11 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
           }
         }
       }
-      if (evt.type === "result" && evt.session_id) { lastSessionId = evt.session_id; saveState(); }
+      if (evt.type === "result" && evt.session_id) {
+        if (settings.backend === "cursor") { cursorSessionId = evt.session_id; }
+        else { lastSessionId = evt.session_id; }
+        saveState();
+      }
       if (evt.type === "result" && evt.result) assistantText = evt.result;
     }
   });
@@ -853,7 +894,8 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
     const stderrLower = stderrBuffer.toLowerCase();
     if (stderrLower.includes("unauthorized") || stderrLower.includes("auth") && stderrLower.includes("fail") ||
         stderrLower.includes("api key") || stderrLower.includes("not logged in")) {
-      await send("Claude authentication error. Run `claude auth` to re-authenticate.");
+      const hint = settings.backend === "cursor" ? "Run `agent login` to authenticate." : "Run `claude auth` to re-authenticate.";
+      await send(`Authentication error. ${hint}`);
       return;
     }
 
@@ -1137,10 +1179,38 @@ bot.onText(/\/budget$/, (msg) => {
 bot.onText(/\/budget (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const v = parseFloat(match[1].replace("$","")); settings.budget = v > 0 ? v : null; send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); });
 
 bot.onText(/\/plan$/, (msg) => { if (!isAuthorized(msg)) return; const p = settings.permissionMode === "plan"; settings.permissionMode = p ? null : "plan"; send(p ? "Plan mode off." : "Plan mode on."); });
-bot.onText(/\/compact/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; if (!lastSessionId) return send("No conversation."); await runClaude("Summarize: key decisions, code state, next steps.", currentSession.dir, msg.message_id); });
+bot.onText(/\/compact/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; if (!getActiveSessionId()) return send("No conversation."); await runClaude("Summarize: key decisions, code state, next steps.", currentSession.dir, msg.message_id); });
 bot.onText(/\/continue$/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; await runClaude("continue where we left off", currentSession.dir, msg.message_id, { continueSession: true }); });
 bot.onText(/\/worktree$/, (msg) => { if (!isAuthorized(msg)) return; settings.worktree = !settings.worktree; send(settings.worktree ? "Worktree on." : "Worktree off."); });
 
+bot.onText(/\/cursor$/, async (msg) => {
+  if (!isAuthorized(msg)) return;
+  if (!resolvedCursorPath) return send("Cursor Agent CLI not found.\nSet CURSOR_PATH in .env or install: https://docs.cursor.com/agent");
+  settings.backend = "cursor";
+  settings.model = null;
+  saveState();
+  const sid = cursorSessionId ? `\nSession: ${cursorSessionId.slice(0, 8)}...` : "\nNew session.";
+  send(`Switched to Cursor Agent.${sid}\n\n/claude — switch back`);
+});
+
+bot.onText(/\/claude$/, async (msg) => {
+  if (!isAuthorized(msg)) return;
+  settings.backend = "claude";
+  settings.model = null;
+  saveState();
+  const sid = lastSessionId ? `\nSession: ${lastSessionId.slice(0, 8)}...` : "\nNew session.";
+  send(`Switched to Claude Code.${sid}\n\n/cursor — switch to Cursor`);
+});
+
+bot.onText(/\/backend$/, async (msg) => {
+  if (!isAuthorized(msg)) return;
+  const label = settings.backend === "cursor" ? "Cursor Agent" : "Claude Code";
+  const cursorAvail = resolvedCursorPath ? "available" : "not found";
+  send(`Backend: ${label}\n\nClaude Code: available\nCursor Agent: ${cursorAvail}`, { keyboard: { inline_keyboard: [
+    [{ text: "Claude Code", callback_data: "be:claude" }, { text: "Cursor Agent", callback_data: "be:cursor" }],
+  ] } });
+});
+
 bot.onText(/\/mode$/, async (msg) => {
   if (!isAuthorized(msg)) return;
   await send("Bot mode: *direct* (default)\n\nSwitch to agent mode for non-blocking execution.\nIn agent mode, heavy tasks run in the background and you can keep chatting.", {
@@ -1176,8 +1246,10 @@ bot.onText(/\/stop/, async (msg) => {
 bot.onText(/\/status/, (msg) => {
   if (!isAuthorized(msg)) return;
   if (!currentSession) return send("No session.", { keyboard: { inline_keyboard: [[{ text: "Pick", callback_data: "show:projects" }]] } });
+  const backendLabel = settings.backend === "cursor" ? "Cursor Agent" : "Claude Code";
   send([
     `Project: ${currentSession.name}`,
+    `Backend: ${backendLabel}`,
     `Model: ${settings.model || "default"} | Effort: ${settings.effort || "default"}`,
     `Vault: ${vault.isUnlocked() ? "unlocked" : "locked"} | Crons: ${activeCrons.size}`,
     runningProcess ? "Working..." : "Ready.",
@@ -1317,6 +1389,16 @@ bot.on("callback_query", async (q) => {
   if (d.startsWith("m:")) { settings.model = d.slice(2) === "default" ? null : d.slice(2); await send(`Model: ${settings.model || "default"}`); return; }
   if (d.startsWith("e:")) { const e = d.slice(2); settings.effort = e === "default" ? null : e; await send(`Effort: ${settings.effort || "default"}`); return; }
   if (d.startsWith("b:")) { const b = d.slice(2); settings.budget = b === "none" ? null : parseFloat(b); await send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); return; }
+  if (d.startsWith("be:")) {
+    const be = d.slice(3);
+    if (be === "cursor" && !resolvedCursorPath) { await send("Cursor Agent CLI not found."); return; }
+    settings.backend = be;
+    settings.model = null;
+    saveState();
+    const label = be === "cursor" ? "Cursor Agent" : "Claude Code";
+    await send(`Switched to ${label}.`);
+    return;
+  }
 
   // Mode switching — writes mode file and restarts bot
   if (d.startsWith("mode:")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "1.9.2",
+  "version": "1.10.0",
   "description": "Your always-on AI coding assistant — Claude Code via Telegram",
   "main": "bot.js",
   "bin": {