@straussenl/opencode-ask-mode 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# opencode-ask-mode
+
+Read-only **Ask Mode** plugin for [OpenCode](https://opencode.ai). Switch to Ask mode when you want to explore a codebase without risking accidental edits.
+
+## What it does
+
+- Registers a new **Ask** agent as a primary mode (selectable in the mode switcher)
+- **Denies all file edits** — cannot create, modify, or delete files
+- **Denies all shell commands** — no bash, no terminal access
+- Pure read-only: search, read, explain, answer questions
+
+## Installation
+
+```bash
+npm install -g opencode-ask-mode
+```
+
+Then add to your global opencode config (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "plugin": ["opencode-ask-mode"]
+}
+```
+
+Restart opencode. The **Ask** mode will appear in your mode switcher.
+
+## Usage
+
+Switch to Ask mode in the opencode TUI, or use `/mode ask`. The assistant can:
+
+- Read files and search the codebase
+- Explain how code works
+- Look up documentation
+- Help debug by reading error output
+
+It **cannot** edit files, run commands, or create plans.
+
+## vs Plan Mode
+
+| Feature | Ask Mode | Plan Mode |
+|---------|----------|-----------|
+| File edits | Denied | Denied |
+| Shell commands | Denied | Allowed |
+| Create plans | No | Yes |
+| Read code | Yes | Yes |
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,40 @@
+import type { Plugin } from "@opencode-ai/plugin"
+
+const askPlugin: Plugin = async (_ctx) => {
+  return {
+    config: (cfg: Record<string, unknown>) => {
+      const agents = (cfg.agent ?? {}) as Record<string, unknown>
+      cfg.agent = agents
+
+      agents["ask"] = {
+        description: "Read-only assistant — ask questions about your codebase. No file edits, no shell commands.",
+        mode: "primary",
+        color: "#22c55e",
+        permission: { edit: "deny", bash: "deny" },
+        prompt: [
+          "You are Ask Mode — a purely read-only assistant.",
+          "",
+          "## What you CAN do",
+          "- Read files and search the codebase",
+          "- Answer questions about the code",
+          "- Explain how things work",
+          "- Look up documentation and references",
+          "- Help understand errors and debug output",
+          "",
+          "## What you CANNOT do",
+          "- Edit, create, or delete any files",
+          "- Run shell commands (no bash, no terminal)",
+          "- Create craft plans or task lists",
+          "- Make any changes to the project",
+          "",
+          "## Behavior",
+          "- When asked to make changes, politely remind the user to switch to a different mode (e.g. Build mode).",
+          "- You may suggest what changes could be made, but always clarify that you cannot execute them.",
+          "- Focus on explanation, analysis, and guidance — not execution.",
+        ].join("\n"),
+      }
+    },
+  }
+}
+
+export default askPlugin

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@straussenl/opencode-ask-mode",
+  "version": "1.0.4",
+  "description": "Read-only Ask mode plugin for OpenCode — no edits, no shell commands, just answers.",
+  "type": "module",
+  "exports": "./index.ts",
+  "files": [
+    "index.ts"
+  ],
+  "scripts": {},
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "ask",
+    "readonly",
+    "agent"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "latest"
+  }
+}