mono-pilot 0.2.0 → 0.2.1

package/README.md

@@ -80,7 +80,7 @@ The full Cursor-styled tool list exposed by the extension:
 - `FetchMcpResource` – fetch a specific MCP resource
 - `ListMcpTools` – discover MCP tools and schemas
 - `CallMcpTool` – invoke MCP tools by name
-- `SwitchMode` – switch interaction mode (`/plan`)
+- `SwitchMode` – switch interaction mode (`option + m`, cycles Plan → Ask → Agent)
 - `ApplyPatch` – apply single-file patches
 
 ## User rules
@@ -143,10 +143,6 @@ The report shows:
 - the runtime envelope built from `<rules>`, `<mcp_instructions>`, `<system_reminder>`, and `<user_query>`
 
 
-## Roadmap
+## License
 
-Project status: MVP (core capabilities are in place and actively evolving).
-
-- Gradually migrate additional Cursor-style tools from `tools/`.
-- Keep compatibility behavior focused and testable, one tool at a time.
-- Expand docs and examples for customization.
+MIT

package/dist/src/extensions/mode-runtime.js

@@ -5,6 +5,12 @@ Plan mode is still active. Continue with the task in the current mode.
 export const AGENT_MODE_SWITCH_REMINDER = `<system_reminder>
 You are now in Agent mode. Continue with the task in the new mode.
 </system_reminder>`;
+export const ASK_MODE_SWITCH_REMINDER = `<system_reminder>
+You are now in Ask mode. Continue with the task in the new mode.
+</system_reminder>`;
+export const ASK_MODE_STILL_ACTIVE_REMINDER = `<system_reminder>
+Ask mode is still active. Continue with the task in the current mode.
+</system_reminder>`;
 export function parseModeStateEntry(entry) {
     if (typeof entry !== "object" || entry === null)
         return undefined;
@@ -17,10 +23,12 @@ export function parseModeStateEntry(entry) {
     if (typeof data !== "object" || data === null)
         return undefined;
     const state = data;
-    if (state.activeMode === "plan" || state.activeMode === "agent") {
+    if (state.activeMode === "plan" || state.activeMode === "agent" || state.activeMode === "ask") {
         return {
             activeMode: state.activeMode,
-            pendingReminder: state.pendingReminder === "plan-entry" || state.pendingReminder === "agent-entry"
+            pendingReminder: state.pendingReminder === "plan-entry" ||
+                state.pendingReminder === "agent-entry" ||
+                state.pendingReminder === "ask-entry"
                 ? state.pendingReminder
                 : undefined,
         };
@@ -83,14 +91,37 @@ class ModeRuntimeStore {
             return { changed: false, snapshot: this.getSnapshot() };
         }
         this.state.activeMode = nextMode;
-        this.state.pendingReminder = nextMode === "plan" ? "plan-entry" : "agent-entry";
+        switch (nextMode) {
+            case "plan":
+                this.state.pendingReminder = "plan-entry";
+                break;
+            case "ask":
+                this.state.pendingReminder = "ask-entry";
+                break;
+            case "agent":
+            default:
+                this.state.pendingReminder = "agent-entry";
+                break;
+        }
         return { changed: true, snapshot: this.getSnapshot() };
     }
     toggleMode() {
-        const nextMode = this.state.activeMode === "plan" ? "agent" : "plan";
+        let nextMode;
+        switch (this.state.activeMode) {
+            case "agent":
+                nextMode = "plan";
+                break;
+            case "plan":
+                nextMode = "ask";
+                break;
+            case "ask":
+            default:
+                nextMode = "agent";
+                break;
+        }
         return this.setMode(nextMode);
     }
-    consumeReminder(planEntryReminder) {
+    consumeReminder(planEntryReminder, askEntryReminder) {
         if (this.state.activeMode === "plan") {
             if (this.state.pendingReminder === "plan-entry") {
                 this.state.pendingReminder = undefined;
@@ -106,6 +137,21 @@ class ModeRuntimeStore {
                 snapshot: this.getSnapshot(),
             };
         }
+        if (this.state.activeMode === "ask") {
+            if (this.state.pendingReminder === "ask-entry") {
+                this.state.pendingReminder = undefined;
+                return {
+                    reminder: askEntryReminder,
+                    changed: true,
+                    snapshot: this.getSnapshot(),
+                };
+            }
+            return {
+                reminder: ASK_MODE_STILL_ACTIVE_REMINDER,
+                changed: false,
+                snapshot: this.getSnapshot(),
+            };
+        }
         if (this.state.pendingReminder === "agent-entry") {
             this.state.pendingReminder = undefined;
             return {

package/dist/src/extensions/user-message.js

@@ -3,9 +3,10 @@ import { readdir, readFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import process from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { buildRuntimeEnvelope, createModeStateData, modeRuntimeStore, MODE_STATE_ENTRY_TYPE, PLAN_MODE_STILL_ACTIVE_REMINDER, } from "./mode-runtime.js";
+import { buildRuntimeEnvelope, createModeStateData, modeRuntimeStore, MODE_STATE_ENTRY_TYPE, ASK_MODE_SWITCH_REMINDER, PLAN_MODE_STILL_ACTIVE_REMINDER, } from "./mode-runtime.js";
 import { createRpcRequestId, extractStringHeaders, isRecord, isServerEnabled, parseMcpConfig, postJsonRpcRequest, resolveMcpConfigPath, toNonEmptyString, MCP_PROTOCOL_VERSION, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, } from "../utils/mcp-client.js";
 const PLAN_MODE_REMINDER_PATH = fileURLToPath(new URL("../../tools/plan-mode-reminder.md", import.meta.url));
+const ASK_MODE_REMINDER_PATH = fileURLToPath(new URL("../../tools/ask-mode-reminder.md", import.meta.url));
 const RULES_RELATIVE_DIR = join(".pi", "rules");
 const MCP_INSTRUCTIONS_DESCRIPTION = "Instructions provided by MCP servers to help use them properly";
 const USER_QUERY_RENDER_PATCH_FLAG = "__monoPilotUserQueryRenderPatched__";
@@ -180,6 +181,7 @@ async function buildRulesEnvelope(workspaceCwd) {
 export default function runtimeEnvelopeExtension(pi) {
     void patchInteractiveModeUserMessageDisplay();
     let planModeReminderCache;
+    let askModeReminderCache;
     let mcpInstructionsCache;
     let rulesEnvelopeCache;
     let mcpInstructionsPending;
@@ -199,6 +201,20 @@ export default function runtimeEnvelopeExtension(pi) {
             return PLAN_MODE_STILL_ACTIVE_REMINDER;
         }
     };
+    const getAskEntryReminder = async () => {
+        if (askModeReminderCache !== undefined) {
+            return askModeReminderCache ?? ASK_MODE_SWITCH_REMINDER;
+        }
+        try {
+            const content = await readFile(ASK_MODE_REMINDER_PATH, "utf-8");
+            askModeReminderCache = content.trim();
+            return askModeReminderCache || ASK_MODE_SWITCH_REMINDER;
+        }
+        catch {
+            askModeReminderCache = null;
+            return ASK_MODE_SWITCH_REMINDER;
+        }
+    };
     const getMcpInstructions = async () => {
         if (mcpInstructionsCache !== undefined) {
             return mcpInstructionsCache ?? undefined;
@@ -242,15 +258,17 @@ export default function runtimeEnvelopeExtension(pi) {
     // Eagerly pre-fetch rules and MCP instructions in the background so the first input isn't delayed
     getRulesEnvelope().catch(() => { });
     getMcpInstructions().catch(() => { });
+    getAskEntryReminder().catch(() => { });
     pi.on("input", async (event) => {
         if (event.source === "extension")
             return;
-        const [planEntryReminder, mcpInstructions, rulesEnvelope] = await Promise.all([
+        const [planEntryReminder, askEntryReminder, mcpInstructions, rulesEnvelope] = await Promise.all([
             getPlanEntryReminder(),
+            getAskEntryReminder(),
             getMcpInstructions(),
             getRulesEnvelope(),
         ]);
-        const { reminder, changed, snapshot } = modeRuntimeStore.consumeReminder(planEntryReminder);
+        const { reminder, changed, snapshot } = modeRuntimeStore.consumeReminder(planEntryReminder, askEntryReminder);
         if (changed) {
             pi.appendEntry(MODE_STATE_ENTRY_TYPE, createModeStateData(snapshot));
         }

package/dist/tools/README.md

@@ -7,7 +7,9 @@ This directory stores the tool layer for `mono-pilot`.
 - `*.ts`: tool implementation (registration, validation, execution)
 - `*.test.ts`: tool unit tests
 - `*-description.md`: shared tool description text consumed by the corresponding tool
-- `plan-mode-reminder.md`: user message prompt fragment used by `/plan`
+- mode reminders
+  - `plan-mode-reminder.md`: system reminder injected when entering Plan mode
+  - `ask-mode-reminder.md`: system reminder injected when entering Ask mode
 
 Tool descriptions are now loaded by the tool implementation and exposed via the system-prompt extension.
 

package/dist/tools/ask-mode-reminder.md

@@ -0,0 +1,30 @@
+<system_reminder>
+You are now in Ask mode. Continue with the task in the new mode.
+</system_reminder>
+
+<system_reminder>
+Ask mode is active. The user wants you to answer questions about their codebase or coding in general. You MUST NOT make any edits, run any non-readonly tools (including changing configs or making commits), or otherwise make any changes to the system. This supersedes any other instructions you have received (for example, to make edits).
+
+Your role in Ask mode:
+
+1. Answer the user's questions comprehensively and accurately. Focus on providing clear, detailed explanations.
+
+2. Use readonly tools to explore the codebase and gather information needed to answer the user's questions. You can:
+   - Read files to understand code structure and implementation
+   - Search the codebase to find relevant code
+   - Use grep to find patterns and usages
+   - List directory contents to understand project structure
+   - Read lints/diagnostics to understand code quality issues
+
+3. Provide code examples and references when helpful, citing specific file paths and line numbers.
+
+4. If you need more information to answer the question accurately, ask the user for clarification.
+
+5. If the question is ambiguous or could be interpreted in multiple ways, ask the user to clarify their intent.
+
+6. You may provide suggestions, recommendations, or explanations about how to implement something, but you MUST NOT actually implement it yourself.
+
+7. Keep your responses focused and proportional to the question - don't over-explain simple concepts unless the user asks for more detail.
+
+8. If the user asks you to make changes or implement something, politely remind them that you're in Ask mode and can only provide information and guidance. Suggest they switch to Agent mode if they want you to make changes.
+</system_reminder>

package/dist/tools/subagent-description.md

@@ -57,7 +57,7 @@ Available subagent_types and a quick description of what they do:
 - browser-use: Perform browser-based testing and web automation. This subagent can navigate web pages, interact with elements, fill forms, and take screenshots. Use this for testing web applications, verifying UI changes, or any browser-based tasks. Use this browser subagent when you need to either: (1) parallelize browser tasks alongside other work, or (2) execute a longer sequence of browser actions that benefit from dedicated context. This subagent_type is stateful; if a browserUse subagent already exists, the previously created subagent will be resumed if you reuse the Task tool with subagent_type set to browserUse. (Auto-resumes most recent agent of this type; `resume` arg is ignored)
 
 Available models:
-- fast (cost: 1/10, intelligence: 5/10): Extremely fast, moderately intelligent model that is effective for tightly scoped changes. Not well-suited for long-horizon tasks or deep investigations.
+- fast: Uses the parent model with thinking effort set to low (same model, lower thinking).
 
 When speaking to the USER about which model you selected for a Task/subagent, do NOT reveal these internal model alias names (e.g., fast, alpha, beta, gamma). Instead, use natural language such as "a faster model", "a more capable model", or "the default model".
 

package/dist/tools/subagent.js

@@ -12,10 +12,9 @@ const SUBAGENTS_DIRNAME = ".pi/subagents";
 const SUBAGENT_ID_PATTERN = /^[a-zA-Z0-9._-]+$/;
 const MAX_PARALLEL_TASKS = 8;
 const MAX_CONCURRENCY = 4;
-const FAST_MODEL_HINTS = ["haiku", "flash", "mini", "small", "nano", "lite", "fast", "instant", "spark"];
 const BUILTIN_SUBAGENT_TYPES = ["generalPurpose", "explore", "shell", "browser-use"];
 const modelAliasSchema = Type.Union([Type.Literal("fast")], {
-    description: 'Optional model alias. If not provided, inherits from parent/model profile. Prefer fast for quick, straightforward tasks to minimize cost and latency; use default/inherited model for deeper reasoning tasks.',
+    description: 'Optional model alias. If not provided, inherits from parent/model profile. "fast" runs the parent model with thinking effort set to low.',
 });
 const subagentTypeSchema = Type.Union([
     Type.Literal("generalPurpose"),
@@ -240,39 +239,16 @@ function listModelCandidates(ctx) {
         return [...availableModels];
     return [...ctx.modelRegistry.getAll()];
 }
-function scoreFastCandidate(model, preferredProvider) {
-    const haystack = `${model.id} ${model.name ?? ""}`.toLowerCase();
-    let score = 0;
-    if (preferredProvider && model.provider === preferredProvider)
-        score += 20;
-    if (FAST_MODEL_HINTS.some((hint) => haystack.includes(hint)))
-        score += 100;
-    if (haystack.includes("opus") || haystack.includes("sonnet") || haystack.includes("pro"))
-        score -= 15;
-    if (haystack.includes("gpt-4") || haystack.includes("gpt-5"))
-        score -= 10;
-    return score;
-}
 function pickInheritedModel(ctx) {
     if (!ctx.model)
         return undefined;
     return { provider: ctx.model.provider, modelId: ctx.model.id };
 }
-function pickFastModel(ctx) {
-    const candidates = listModelCandidates(ctx);
-    if (candidates.length === 0)
+function pickLowThinkingModel(ctx) {
+    const inherited = pickInheritedModel(ctx);
+    if (!inherited)
         return undefined;
-    const preferredProvider = ctx.model?.provider;
-    candidates.sort((a, b) => {
-        const scoreDiff = scoreFastCandidate(b, preferredProvider) - scoreFastCandidate(a, preferredProvider);
-        if (scoreDiff !== 0)
-            return scoreDiff;
-        if (a.provider !== b.provider)
-            return a.provider.localeCompare(b.provider);
-        return a.id.localeCompare(b.id);
-    });
-    const picked = candidates[0];
-    return { provider: picked.provider, modelId: picked.id };
+    return { ...inherited, thinking: "low" };
 }
 function pickModelBySpec(ctx, spec) {
     const normalized = spec.trim();
@@ -282,7 +258,7 @@ function pickModelBySpec(ctx, spec) {
     if (lowered === "inherit")
         return pickInheritedModel(ctx);
     if (lowered === "fast")
-        return pickFastModel(ctx) ?? pickInheritedModel(ctx);
+        return pickLowThinkingModel(ctx) ?? pickInheritedModel(ctx);
     const slashIndex = normalized.indexOf("/");
     if (slashIndex > 0) {
         const provider = normalized.slice(0, slashIndex);
@@ -303,7 +279,7 @@ function pickModelBySpec(ctx, spec) {
 }
 function selectModelForTask(ctx, explicitAlias, profileModelSpec) {
     if (explicitAlias === "fast") {
-        return pickFastModel(ctx) ?? pickInheritedModel(ctx);
+        return pickLowThinkingModel(ctx) ?? pickInheritedModel(ctx);
     }
     if (profileModelSpec) {
         return pickModelBySpec(ctx, profileModelSpec) ?? pickInheritedModel(ctx);
@@ -748,6 +724,9 @@ async function executeTask(task, index, options) {
     ];
     if (selectedModel) {
         args.push("--provider", selectedModel.provider, "--model", selectedModel.modelId);
+        if (selectedModel.thinking === "low") {
+            args.push("--thinking", "low");
+        }
     }
     for (const attachment of attachments) {
         args.push(`@${attachment}`);

package/dist/tools/switch-mode.js

@@ -1,7 +1,7 @@
 import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
 import { Type } from "@sinclair/typebox";
 import { createModeStateData, deriveInitialModeState, hasMessageEntries, modeRuntimeStore, MODE_STATE_ENTRY_TYPE, parseModeStateEntry, } from "../src/extensions/mode-runtime.js";
-const MODE_HINT_MESSAGE_TYPE = "switch-mode-hint";
+const MODE_HINT_MESSAGE_TYPE = "Hints";
 const MODE_STATUS_KEY = "mono-pilot-mode";
 const DESCRIPTION = `Switch the interaction mode to better match the current task. Each mode is optimized for a specific type of work.
 
@@ -252,7 +252,11 @@ function updateModeStatus(ctx) {
     if (!ctx.hasUI)
         return;
     const { activeMode } = modeRuntimeStore.getSnapshot();
-    const statusText = activeMode === "plan" ? ctx.ui.theme.fg("warning", "mode:plan") : ctx.ui.theme.fg("muted", "mode:agent");
+    const statusText = activeMode === "plan"
+        ? ctx.ui.theme.fg("warning", "mode:plan")
+        : activeMode === "ask"
+            ? ctx.ui.theme.fg("borderAccent", "mode:ask")
+            : ctx.ui.theme.fg("muted", "mode:agent");
     ctx.ui.setStatus(MODE_STATUS_KEY, statusText);
 }
 function persistModeState(pi) {
@@ -273,7 +277,8 @@ function togglePlanMode(pi, ctx) {
     persistModeState(pi);
     updateModeStatus(ctx);
     if (ctx.hasUI) {
-        ctx.ui.notify(`Switched to ${snapshot.activeMode === "plan" ? "Plan" : "Agent"} mode.`);
+        const label = snapshot.activeMode === "plan" ? "Plan" : snapshot.activeMode === "ask" ? "Ask" : "Agent";
+        ctx.ui.notify(`Switched to ${label} mode.`);
     }
 }
 export default function switchModeExtension(pi) {
@@ -282,9 +287,11 @@ export default function switchModeExtension(pi) {
         type: "boolean",
         default: false,
     });
-    pi.registerCommand("plan", {
-        description: "Toggle between Plan mode and Agent mode",
-        handler: async (_args, ctx) => togglePlanMode(pi, ctx),
+    pi.registerShortcut("alt+m", {
+        description: "Cycle between Plan, Ask, and Agent modes",
+        handler: async (ctx) => {
+            togglePlanMode(pi, ctx);
+        }
     });
     pi.on("session_start", async (_event, ctx) => {
         const fromFlag = pi.getFlag("plan") === true;
@@ -307,7 +314,7 @@ export default function switchModeExtension(pi) {
         if (ctx.hasUI && !hasMessageEntries(entries)) {
             pi.sendMessage({
                 customType: MODE_HINT_MESSAGE_TYPE,
-                content: "Mode switch: use `/plan` to toggle Plan/Agent mode.",
+                content: "Mode switch: use `option+m` to toggle Plan/Ask/Agent mode.",
                 display: true,
             }, { triggerTurn: false });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mono-pilot",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Cursor-compatible coding agent powered by pi-mono",
   "type": "module",
   "license": "MIT",