feat(doomscroll): add X timeline GUI plugin

.changeset/40f76543.md

@@ -0,0 +1,5 @@
+---
+"@mynameistito/opencode-doomscroll": minor
+---
+
+Add an experimental GUI plugin that opens X's home timeline while an OpenCode session runs and closes the tab when the run ends.

knip.json

@@ -16,6 +16,9 @@
     },
     "apps/web": {
       "entry": ["alchemy.run.ts", "blume.config.ts"]
+    },
+    "packages/opencode-doomscroll": {
+      "entry": ["src/gui.tsx"]
     }
   }
 }

packages/opencode-doomscroll/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mynameistito
+
+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.

packages/opencode-doomscroll/README.md

@@ -0,0 +1,52 @@
+# @mynameistito/opencode-doomscroll
+
+An experimental OpenCode Desktop GUI plugin that opens X's home timeline in OpenCode's built-in browser when a session starts running. It closes the tab it opened when the run ends. OpenCode does not automate scrolling or interact with X.
+
+## Local development
+
+1. From the monorepo root, install dependencies and build the GUI bundle:
+
+   ```powershell
+   bun install --frozen-lockfile
+   cd packages/opencode-doomscroll
+   bun run build
+   ```
+
+2. Edit `%USERPROFILE%\.config\opencode\opencode.json` (or `.jsonc`) and add the package directory to its `plugins` list. Use an absolute path to this checkout, for example:
+
+   ```json
+   {
+     "$schema": "https://opencode.ai/v2/opencode.json",
+     "plugins": [
+       "C:/Users/mynameistito/code/opencode-plugins/packages/opencode-doomscroll"
+     ]
+   }
+   ```
+
+   Merge that plugin entry into your existing global config rather than replacing other settings. The Desktop app reads `opencode.json`, not `cli.json`.
+
+3. Restart OpenCode Desktop. Start a session; when it begins running, the plugin opens `https://x.com/home` in OpenCode's browser pane. The tab closes when the run succeeds, fails, or is interrupted. Sign in in the browser pane if X asks.
+
+For live development, leave this running while Desktop is open:
+
+```powershell
+cd packages/opencode-doomscroll
+bun run dev
+```
+
+Each rebuild reloads the GUI plugin. Pause automatic opening from the Doomscroll settings page; this switch applies to the current window. You can open X manually from the command palette with “Open X”.
+
+To keep automatic opening disabled after a restart, configure the plugin entry with an option:
+
+```json
+{
+  "plugins": [
+    {
+      "package": "C:/Users/mynameistito/code/opencode-plugins/packages/opencode-doomscroll",
+      "options": { "autoOpen": false }
+    }
+  ]
+}
+```
+
+The GUI plugin API is experimental in OpenCode v2. It requires OpenCode Desktop and its built-in Browser plugin.

packages/opencode-doomscroll/package.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@mynameistito/opencode-doomscroll",
+  "version": "0.1.0",
+  "description": "Open X in OpenCode Desktop while a session is running.",
+  "keywords": [
+    "ai-coding",
+    "desktop",
+    "opencode",
+    "opencode-plugin",
+    "twitter",
+    "x"
+  ],
+  "homepage": "https://github.com/mynameistito/opencode-plugins/tree/main/packages/opencode-doomscroll#readme",
+  "bugs": {
+    "url": "https://github.com/mynameistito/opencode-plugins/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Tito",
+    "email": "github@mynameistito.com",
+    "url": "https://github.com/mynameistito"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mynameistito/opencode-plugins.git",
+    "directory": "packages/opencode-doomscroll"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    "./gui-experimental": "./dist/gui-experimental.cjs"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@opencode/plugin": "catalog:"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "effect": "4.0.1",
+    "solid-js": "catalog:",
+    "typescript": "catalog:",
+    "vite": "^8.0.0",
+    "vite-plugin-solid": "2.11.14"
+  },
+  "packageManager": "bun@1.4.2"
+}