@inetafrica/open-claudia 1.10.1 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v1.11.0
+- Backend-aware plan mode: /plan passes `--mode plan` to Cursor Agent, `--permission-mode plan` to Claude
+- New /ask command: read-only Q&A mode (Cursor Agent only, `--mode ask`)
+- /effort and /budget now warn when on Cursor backend (unsupported flags)
+- Worktree flag (`--worktree`) wired into Cursor Agent args
+- buildCursorArgs now forwards plan/ask/worktree settings
+
 ## v1.10.0
 - Cursor Agent backend: switch between Claude Code and Cursor Agent CLI
 - New commands: /cursor, /claude, /backend with inline keyboard

package/README.md

@@ -126,7 +126,8 @@ When you select a project, the last conversation is automatically resumed. Tap "
 | `/model` | Switch model (opus / sonnet / haiku for Claude; any model flag for Cursor) |
 | `/effort` | Set effort level (low / medium / high / max) |
 | `/budget` | Set max spend for next task (e.g. `/budget 0.50`) — Claude only |
-| `/plan` | Toggle plan mode — Claude only |
+| `/plan` | Toggle plan mode — `--permission-mode plan` (Claude) / `--mode plan` (Cursor) |
+| `/ask` | Toggle ask mode — read-only Q&A, no edits (Cursor Agent only) |
 | `/compact` | Summarize conversation context |
 | `/worktree` | Toggle isolated git branch — Claude only |
 | `/mode` | Switch between direct and agent bot modes |
@@ -158,9 +159,10 @@ When you select a project, the last conversation is automatically resumed. Tap "
 | Session flag | `--resume <id>` | `--resume <id>` |
 | Auth | `claude auth` | `agent login` |
 | Plan mode | Yes (`--permission-mode plan`) | Yes (`--mode plan`) |
+| Ask mode | No | Yes (`--mode ask`) |
 | Budget control | Yes (`--max-budget-usd`) | No |
 | Effort levels | Yes | No |
-| Worktree | Yes | No |
+| Worktree | Yes (`--worktree`) | Yes (`--worktree`) |
 | Model switching | Yes | Yes |
 | Dangerously skip permissions | Yes | Yes (`--trust`) |
 

package/bot-agent.js

@@ -178,6 +178,7 @@ bot.setMyCommands([
   { command: "effort", description: "Set effort level" },
   { command: "budget", description: "Set max spend for next task" },
   { command: "plan", description: "Toggle plan mode" },
+  { command: "ask", description: "Toggle ask mode (Cursor only)" },
   { command: "sessions", description: "List conversations for this project" },
   { command: "compact", description: "Summarize conversation context" },
   { command: "continue", description: "Resume last conversation" },
@@ -696,6 +697,9 @@ function buildCursorArgs(prompt, opts = {}) {
   if (opts.continueSession) args.push("--continue");
   else if (cursorSessionId && !opts.fresh) args.push("--resume", cursorSessionId);
   if (settings.model) args.push("--model", settings.model);
+  if (settings.permissionMode === "plan") args.push("--mode", "plan");
+  else if (settings.permissionMode === "ask") args.push("--mode", "ask");
+  if (settings.worktree) args.push("--worktree");
   args.push(prompt);
   return args;
 }
@@ -1126,23 +1130,46 @@ bot.onText(/\/model (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; set
 
 bot.onText(/\/effort$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Effort: ${settings.effort || "default"}`, { keyboard: { inline_keyboard: [
     [{ text: "Low", callback_data: "e:low" }, { text: "Med", callback_data: "e:medium" }, { text: "High", callback_data: "e:high" }, { text: "Max", callback_data: "e:max" }],
     [{ text: "Default", callback_data: "e:default" }],
   ] } });
 });
-bot.onText(/\/effort (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`); });
+bot.onText(/\/effort (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.");
+  const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`);
+});
 
 bot.onText(/\/budget$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Budget: ${settings.budget ? "$" + settings.budget : "none"}`, { keyboard: { inline_keyboard: [
     [{ text: "$1", callback_data: "b:1" }, { text: "$5", callback_data: "b:5" }, { text: "$10", callback_data: "b:10" }, { text: "$25", callback_data: "b:25" }],
     [{ text: "No limit", callback_data: "b:none" }],
   ] } });
 });
-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(/\/budget (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.");
+  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(/\/plan$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  const p = settings.permissionMode === "plan";
+  settings.permissionMode = p ? null : "plan";
+  const label = settings.backend === "cursor" ? "read-only planning, no edits" : "plan permission mode";
+  send(p ? "Plan mode off." : `Plan mode on (${label}).`);
+});
+bot.onText(/\/ask$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend !== "cursor") return send("Ask mode is only available on Cursor Agent.\nUse /cursor to switch.");
+  const a = settings.permissionMode === "ask";
+  settings.permissionMode = a ? null : "ask";
+  send(a ? "Ask mode off." : "Ask mode on (read-only Q&A, no edits).");
+});
 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."); });

package/bot.js

@@ -236,6 +236,7 @@ bot.setMyCommands([
   { command: "effort", description: "Set effort level" },
   { command: "budget", description: "Set max spend for next task" },
   { command: "plan", description: "Toggle plan mode" },
+  { command: "ask", description: "Toggle ask mode (Cursor only)" },
   { command: "sessions", description: "List conversations for this project" },
   { command: "compact", description: "Summarize conversation context" },
   { command: "continue", description: "Resume last conversation" },
@@ -757,6 +758,9 @@ function buildCursorArgs(prompt, opts = {}) {
   if (opts.continueSession) args.push("--continue");
   else if (cursorSessionId && !opts.fresh) args.push("--resume", cursorSessionId);
   if (settings.model) args.push("--model", settings.model);
+  if (settings.permissionMode === "plan") args.push("--mode", "plan");
+  else if (settings.permissionMode === "ask") args.push("--mode", "ask");
+  if (settings.worktree) args.push("--worktree");
   args.push(prompt);
   return args;
 }
@@ -1169,23 +1173,46 @@ bot.onText(/\/model (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; set
 
 bot.onText(/\/effort$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Effort: ${settings.effort || "default"}`, { keyboard: { inline_keyboard: [
     [{ text: "Low", callback_data: "e:low" }, { text: "Med", callback_data: "e:medium" }, { text: "High", callback_data: "e:high" }, { text: "Max", callback_data: "e:max" }],
     [{ text: "Default", callback_data: "e:default" }],
   ] } });
 });
-bot.onText(/\/effort (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`); });
+bot.onText(/\/effort (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.");
+  const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`);
+});
 
 bot.onText(/\/budget$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Budget: ${settings.budget ? "$" + settings.budget : "none"}`, { keyboard: { inline_keyboard: [
     [{ text: "$1", callback_data: "b:1" }, { text: "$5", callback_data: "b:5" }, { text: "$10", callback_data: "b:10" }, { text: "$25", callback_data: "b:25" }],
     [{ text: "No limit", callback_data: "b:none" }],
   ] } });
 });
-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(/\/budget (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.");
+  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(/\/plan$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  const p = settings.permissionMode === "plan";
+  settings.permissionMode = p ? null : "plan";
+  const label = settings.backend === "cursor" ? "read-only planning, no edits" : "plan permission mode";
+  send(p ? "Plan mode off." : `Plan mode on (${label}).`);
+});
+bot.onText(/\/ask$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend !== "cursor") return send("Ask mode is only available on Cursor Agent.\nUse /cursor to switch.");
+  const a = settings.permissionMode === "ask";
+  settings.permissionMode = a ? null : "ask";
+  send(a ? "Ask mode off." : "Ask mode on (read-only Q&A, no edits).");
+});
 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."); });

package/package.json

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