opencode-terminal-progress 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Pombeiro
+
+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,42 @@
+# opencode-terminal-progress
+
+An [OpenCode](https://opencode.ai) plugin that shows agent progress in your terminal tab using
+[OSC 9;4](https://iterm2.com/documentation-escape-codes.html) progress reporting.
+
+## Supported terminals
+
+| Terminal                                                  | Detection                                               |
+| --------------------------------------------------------- | ------------------------------------------------------- |
+| [iTerm2](https://iterm2.com)                              | `TERM_PROGRAM=iTerm.app`, `LC_TERMINAL`, `ITERM_SESSION_ID` |
+| [WezTerm](https://wezfurlong.org/wezterm/)                | `TERM_PROGRAM=WezTerm`, `WEZTERM_EXECUTABLE`            |
+| [Windows Terminal](https://github.com/microsoft/terminal) | `WT_SESSION`                                            |
+
+The plugin automatically detects which terminal is in use and becomes a no-op if none of the above
+are found. tmux passthrough is handled transparently when `$TMUX` is set.
+
+## Progress states
+
+| Agent state         | Progress indicator |
+| ------------------- | ------------------ |
+| Busy                | Indeterminate      |
+| Idle                | Cleared            |
+| Error               | Error (red)        |
+| Waiting for input   | Paused at 50%      |
+
+## Installation
+
+```bash
+npm install opencode-terminal-progress
+```
+
+Add to your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-terminal-progress"]
+}
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/index.js

@@ -0,0 +1,52 @@
+// @bun
+// src/index.ts
+function detectTerminal() {
+  const env = process.env;
+  if (env["TERM_PROGRAM"] === "iTerm.app" || env["LC_TERMINAL"] === "iTerm2" || env["ITERM_SESSION_ID"]) {
+    return "iterm2";
+  }
+  if (env["TERM_PROGRAM"] === "WezTerm" || env["WEZTERM_EXECUTABLE"]) {
+    return "wezterm";
+  }
+  if (env["WT_SESSION"]) {
+    return "windows-terminal";
+  }
+  return;
+}
+function osc(payload) {
+  const esc = process.env["TMUX"] ? `\x1BPtmux;\x1B\x1B]${payload}\x07\x1B\\` : `\x1B]${payload}\x07`;
+  process.stdout.write(esc);
+}
+function progress(code) {
+  osc(`9;4;${code}`);
+}
+var TerminalProgressPlugin = async () => {
+  const terminal = detectTerminal();
+  if (!terminal)
+    return {};
+  return {
+    event: async ({ event }) => {
+      if (event.type === "session.status") {
+        const { status } = event.properties;
+        if (status.type === "busy") {
+          progress("3");
+        } else if (status.type === "idle") {
+          progress("0");
+        }
+      } else if (event.type === "session.error") {
+        progress("2");
+      }
+    },
+    "permission.ask": async () => {
+      progress("4;50");
+    },
+    "tool.execute.before": async (input) => {
+      if (input.tool === "question") {
+        progress("4;50");
+      }
+    }
+  };
+};
+export {
+  TerminalProgressPlugin
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "opencode-terminal-progress",
+  "version": "0.1.0",
+  "description": "OpenCode plugin that shows agent progress in terminal tabs (iTerm2, WezTerm, Windows Terminal)",
+  "author": {
+    "name": "Pedro Pombeiro",
+    "email": "pedropombeiro@users.noreply.github.com"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pedropombeiro/opencode-terminal-progress.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "terminal",
+    "progress",
+    "iterm2",
+    "wezterm",
+    "windows-terminal",
+    "osc"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.85"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@opencode-ai/plugin": "1.0.85",
+    "@types/node": "^20.11.5",
+    "bun-types": "1.3.10",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-prettier": "^5.1.3",
+    "prettier": "^3.2.4",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.47.0"
+  }
+}