opencode-miniterm 1.0.0

package/.prettierrc

@@ -0,0 +1,16 @@
+{
+	"useTabs": true,
+	"printWidth": 100,
+	"trailingComma": "all",
+	"plugins": ["@trivago/prettier-plugin-sort-imports"],
+	"importOrder": ["^[../]", "^[./]"],
+	"importOrderSortSpecifiers": true,
+	"overrides": [
+		{
+			"files": ["*.json", "*.jsonc"],
+			"options": {
+				"trailingComma": "none"
+			}
+		}
+	]
+}

package/AGENTS.md

@@ -0,0 +1,243 @@
+# OpenCode MiniTerm - Agent Guidelines
+
+## Build & Development Commands
+
+### Run the application
+```bash
+bun run src/index.ts
+# Or just:
+bun src/index.ts
+```
+
+### Build (when bundler is added)
+```bash
+bun build src/index.ts --outdir dist
+```
+
+### Testing
+No test framework is currently configured. Add one of these to package.json:
+- **Bun Test**: `bun test` (recommended - built-in, fast)
+- **Jest**: `npm test` or `bun run test`
+- **Vitest**: `vitest`
+
+To run a single test (once configured):
+- Bun Test: `bun test --test-name-pattern "testName"`
+- Jest: `npm test -- testName`
+- Vitest: `vitest run testName`
+
+### Linting & Formatting (recommended additions)
+Install and configure these tools:
+```bash
+bun add -d eslint @typescript-eslint/eslint-plugin @typescript-eslint/parser prettier
+```
+
+Commands to add to package.json:
+```json
+{
+  "lint": "eslint src --ext .ts",
+  "lint:fix": "eslint src --ext .ts --fix",
+  "format": "prettier --write \"src/**/*.ts\"",
+  "format:check": "prettier --check \"src/**/*.ts\"",
+  "typecheck": "tsc --noEmit"
+}
+```
+
+## Code Style Guidelines
+
+### TypeScript Configuration
+- Use strict mode: `"strict": true` in tsconfig.json
+- Target ES2022+ for modern Node/Bun features
+- Use `moduleResolution: "bundler"` for Bun compatibility
+
+### Imports
+- Use ES6 imports (ESM): `import { something } from 'module'`
+- Group imports in this order:
+  1. Node/Bun built-ins
+  2. External packages
+  3. Internal modules
+- Use absolute imports where possible (configure path aliases in tsconfig.json)
+- Avoid default exports; prefer named exports for better tree-shaking
+
+### Formatting
+- Use 2 spaces for indentation
+- Use single quotes for strings
+- Use semicolons at end of statements
+- Maximum line length: 100 characters
+- Trailing commas in multi-line arrays/objects
+- Spaces around operators: `a = b + c` not `a=b+c`
+
+### Types & Type Safety
+- Always provide explicit return types for functions
+- Use `interface` for object shapes, `type` for unions/primitives
+- Avoid `any`; use `unknown` when type is truly unknown
+- Use type guards for runtime type checking
+- Leverage Bun's built-in type definitions (from `bun-types`)
+
+### Naming Conventions
+- **Files**: kebab-case: `my-service.ts`
+- **Variables/Functions**: camelCase: `myFunction`
+- **Classes**: PascalCase: `MyService`
+- **Constants**: UPPER_SNAKE_CASE for global constants: `MAX_RETRIES`
+- **Private members**: Leading underscore: `_privateMethod`
+- **Types/Interfaces**: PascalCase, often with suffixes: `UserService`, `ConfigOptions`
+
+### Error Handling
+- Use try/catch for async operations
+- Create custom error classes for domain-specific errors:
+  ```ts
+  class TerminalError extends Error {
+    constructor(message: string, public code: string) {
+      super(message);
+      this.name = 'TerminalError';
+    }
+  }
+  ```
+- Always include error context in error messages
+- Log errors appropriately (avoid logging secrets)
+- Never swallow errors silently
+
+### Async/Promise Handling
+- Use async/await over .then()/.catch()
+- Handle promise rejections: `process.on('unhandledRejection')`
+- Use Bun's optimized APIs where available (e.g., `Bun.file()`)
+- Implement timeouts for network requests
+
+### Code Organization
+- Structure by feature/domain, not by file type
+- Keep files focused: one responsibility per file
+- Export at file end; avoid export分散
+- Use barrel files (`index.ts`) for cleaner imports
+
+### Comments
+- Use JSDoc for public APIs: `/** @description ... */`
+- Comment WHY, not WHAT
+- Keep comments current with code changes
+- Avoid inline comments for obvious logic
+
+### Performance (Bun-Specific)
+- Leverage Bun's fast I/O: `Bun.write()`, `Bun.file()`
+- Use `TextEncoder`/`TextDecoder` for encoding
+- Prefer native over polyfills
+- Benchmark before optimizing
+
+## Project Context
+
+This is an alternative terminal UI for OpenCode. Focus on:
+- Fast, responsive terminal rendering
+- Clean CLI UX with good error messages
+- Efficient resource usage (memory/CPU)
+- Compatibility with OpenCode's API
+
+## File Organization
+
+- Create all temporary files in `./tmp` directory
+- Avoid using `/tmp` or system temp directories
+- The `tmp` folder is gitignored and safe for transient files
+- Clean up temporary files after use to keep the directory organized
+
+## OpenCode Server Integration
+
+### Starting the Server
+- Use `opencode serve` to start a headless HTTP server (not `opencode server`)
+- Default URL: `http://127.0.0.1:4096` (port may vary, can be 0/random)
+- Server requires 2-3 seconds to initialize before accepting requests
+- Spawn with `stdio: ['ignore', 'pipe', 'pipe']` to avoid interfering with parent I/O
+- Always handle SIGINT to properly shut down the server process
+
+### Authentication
+- Server may require HTTP Basic Auth if `OPENCODE_SERVER_PASSWORD` is set
+- Username: `OPENCODE_SERVER_USERNAME` env var (default: 'opencode')
+- Password: `OPENCODE_SERVER_PASSWORD` env var (required if server has password set)
+- Include `Authorization: Basic <base64(username:password)>` header when password is set
+- Include `Content-Type: application/json` header for all POST requests
+- Check env vars at startup: `echo $OPENCODE_SERVER_PASSWORD` to verify it's set
+
+### Creating Sessions
+```ts
+POST /session
+Headers: { "Content-Type": "application/json", "Authorization": "Basic <creds>" }
+Body: {}
+Response: { id: string, title?: string, ... }
+```
+
+### Getting Available Models
+```ts
+GET /config/providers
+Headers: { "Authorization": "Basic <creds>" }
+Response: { providers: Provider[], default: { [key: string]: string } }
+```
+Note: `/models` endpoint returns HTML documentation, not JSON. Use `/config/providers` for programmatic access.
+
+### Sending Messages
+```ts
+POST /session/:id/message
+Headers: { "Content-Type": "application/json", "Authorization": "Basic <creds>" }
+Body: {
+  model: {
+    modelID: 'big-pickle',
+    providerID: 'opencode'
+  },
+  parts: [{ type: 'text', text: 'your message here' }]
+}
+Response: { info: Message, parts: Part[] }
+```
+
+### Getting Session Messages
+```ts
+GET /session/:id/message
+Headers: { "Authorization": "Basic <creds>" }
+Response: { info: Message, parts: Part[] }[]
+```
+
+### Undoing Messages (Revert)
+```ts
+POST /session/:id/revert
+Headers: { "Content-Type": "application/json", "Authorization": "Basic <creds>" }
+Body: { messageID: string, partID?: string }
+Response: { id: string, revert: { messageID, snapshot, diff } }
+```
+Typically used to undo the last assistant message by fetching messages first, then reverting the last one.
+
+**IMPORTANT**: The `model` field is required when sending messages. Without it, the request will hang indefinitely. Get available models from `GET /config/providers` or `GET /models`. Common models:
+- `big-pickle` (opencode provider) - default, high quality
+- `glm-5-free` (opencode provider) - free GLM model
+- `gpt-5-nano` (opencode provider) - fast GPT model
+
+### Response Format
+- Response has `{ info, parts }` structure
+- Parts can be: `step-start`, `reasoning`, `text`, `step-finish`, `tool_use`, `tool_result`
+- `step-start` - Indicates beginning of a thinking/processing step
+- `reasoning` - AI's internal reasoning/thinking process (shows "💭 Thinking...")
+- `text` - The actual AI response to display to the user
+- `step-finish` - Indicates completion of a thinking/processing step
+- `tool_use` - Indicates an AI tool is being used
+- `tool_result` - Contains result of tool execution (can be filtered out)
+- Display reasoning and text parts to the user for transparency
+
+### Server-Sent Events (SSE)
+- Connect to event stream at `/event` for real-time updates
+- Events include: `message.part.updated`, `session.status`, `session.updated`, `message.updated`, `session.diff`, `session.idle`
+- Event structure: `{ type: string, properties: {...} }`
+- Parts can be streamed via `message.part.updated` events with delta updates
+- Delta is at `event.properties.delta`, NOT in `event.properties.part.delta`
+- Use `seenParts` set to track processed parts and avoid duplicate display
+- Delta updates allow streaming reasoning and text for better UX
+
+### Error Handling
+- Server returns 401 Unauthorized when authentication is missing/invalid
+- Handle connection errors (server may not be ready yet)
+- Always parse error text from response for debugging
+- Bun's fetch doesn't timeout by default - use AbortController for timeouts:
+  ```ts
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 180000);
+  const response = await fetch(url, { signal: controller.signal });
+  clearTimeout(timeout);
+  ```
+
+## Safety Notes
+
+- Never commit API keys, tokens, or secrets
+- Validate all user inputs
+- Sanitize terminal output to prevent injection
+- Use environment variables for configuration

package/README.md

@@ -0,0 +1,5 @@
+# OpenCode Miniterm
+
+A small front-end terminal UI for [OpenCode](https://github.com/anomalyco/opencode).
+
+This project is not affiliated with OpenCode.

package/bun.lock

@@ -0,0 +1,108 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "opencode-miniterm",
+      "dependencies": {
+        "@opencode-ai/sdk": "^1.2.10",
+        "allmark": "^1.0.0",
+      },
+      "devDependencies": {
+        "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+        "@types/bun": "latest",
+        "@typescript/native-preview": "7.0.0-dev.20260122.2",
+        "prettier": "^3.8.1",
+        "typescript": "^5.9.3",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@babel/code-frame": ["@babel/code-frame@7.29.0", "", { "dependencies": { "@babel/helper-validator-identifier": "^7.28.5", "js-tokens": "^4.0.0", "picocolors": "^1.1.1" } }, "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw=="],
+
+    "@babel/generator": ["@babel/generator@7.29.1", "", { "dependencies": { "@babel/parser": "^7.29.0", "@babel/types": "^7.29.0", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" } }, "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw=="],
+
+    "@babel/helper-globals": ["@babel/helper-globals@7.28.0", "", {}, "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw=="],
+
+    "@babel/helper-string-parser": ["@babel/helper-string-parser@7.27.1", "", {}, "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA=="],
+
+    "@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.28.5", "", {}, "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q=="],
+
+    "@babel/parser": ["@babel/parser@7.29.0", "", { "dependencies": { "@babel/types": "^7.29.0" }, "bin": "./bin/babel-parser.js" }, "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww=="],
+
+    "@babel/template": ["@babel/template@7.28.6", "", { "dependencies": { "@babel/code-frame": "^7.28.6", "@babel/parser": "^7.28.6", "@babel/types": "^7.28.6" } }, "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ=="],
+
+    "@babel/traverse": ["@babel/traverse@7.29.0", "", { "dependencies": { "@babel/code-frame": "^7.29.0", "@babel/generator": "^7.29.0", "@babel/helper-globals": "^7.28.0", "@babel/parser": "^7.29.0", "@babel/template": "^7.28.6", "@babel/types": "^7.29.0", "debug": "^4.3.1" } }, "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA=="],
+
+    "@babel/types": ["@babel/types@7.29.0", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A=="],
+
+    "@jridgewell/gen-mapping": ["@jridgewell/gen-mapping@0.3.13", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.0", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA=="],
+
+    "@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.2", "", {}, "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw=="],
+
+    "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
+
+    "@jridgewell/trace-mapping": ["@jridgewell/trace-mapping@0.3.31", "", { "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" } }, "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw=="],
+
+    "@opencode-ai/sdk": ["@opencode-ai/sdk@1.2.10", "", {}, "sha512-SyXcVqry2hitPVvQtvXOhqsWyFhSycG/+LTLYXrcq8AFmd9FR7dyBSDB3f5Ol6IPkYOegk8P2Eg2kKPNSNiKGw=="],
+
+    "@trivago/prettier-plugin-sort-imports": ["@trivago/prettier-plugin-sort-imports@6.0.2", "", { "dependencies": { "@babel/generator": "^7.28.0", "@babel/parser": "^7.28.0", "@babel/traverse": "^7.28.0", "@babel/types": "^7.28.0", "javascript-natural-sort": "^0.7.1", "lodash-es": "^4.17.21", "minimatch": "^9.0.0", "parse-imports-exports": "^0.2.4" }, "peerDependencies": { "@vue/compiler-sfc": "3.x", "prettier": "2.x - 3.x", "prettier-plugin-ember-template-tag": ">= 2.0.0", "prettier-plugin-svelte": "3.x", "svelte": "4.x || 5.x" }, "optionalPeers": ["@vue/compiler-sfc", "prettier-plugin-ember-template-tag", "prettier-plugin-svelte", "svelte"] }, "sha512-3DgfkukFyC/sE/VuYjaUUWoFfuVjPK55vOFDsxD56XXynFMCZDYFogH2l/hDfOsQAm1myoU/1xByJ3tWqtulXA=="],
+
+    "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
+
+    "@types/node": ["@types/node@25.3.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-4K3bqJpXpqfg2XKGK9bpDTc6xO/xoUP/RBWS7AtRMug6zZFaRekiLzjVtAoZMquxoAbzBvy5nxQ7veS5eYzf8A=="],
+
+    "@typescript/native-preview": ["@typescript/native-preview@7.0.0-dev.20260122.2", "", { "optionalDependencies": { "@typescript/native-preview-darwin-arm64": "7.0.0-dev.20260122.2", "@typescript/native-preview-darwin-x64": "7.0.0-dev.20260122.2", "@typescript/native-preview-linux-arm": "7.0.0-dev.20260122.2", "@typescript/native-preview-linux-arm64": "7.0.0-dev.20260122.2", "@typescript/native-preview-linux-x64": "7.0.0-dev.20260122.2", "@typescript/native-preview-win32-arm64": "7.0.0-dev.20260122.2", "@typescript/native-preview-win32-x64": "7.0.0-dev.20260122.2" }, "bin": { "tsgo": "bin/tsgo.js" } }, "sha512-+bVirfVpvhDG/oJWzA1c9HX6fC5Wu2hPv3LdBcpf0UtOu0KoWBN+B4L0wYY9gvxvvoxGmupdRCqaM8hRNlXzaw=="],
+
+    "@typescript/native-preview-darwin-arm64": ["@typescript/native-preview-darwin-arm64@7.0.0-dev.20260122.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-rpy7WzXpETCIc+QBfE8J1RpNxvb/5pnKh98DbC4gXpxHKrkjkg0LX86CJSoPaCF6xGcfRsegi49q+bXrtH4LWQ=="],
+
+    "@typescript/native-preview-darwin-x64": ["@typescript/native-preview-darwin-x64@7.0.0-dev.20260122.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-s1Zn16TqesG2x4wx5cKciyfmffZRhJO2fBSN4fQ6bBWbrZHT8KnjJUpoRd8t+JAXsHfxDy4S/S0DcmX5eRfAHQ=="],
+
+    "@typescript/native-preview-linux-arm": ["@typescript/native-preview-linux-arm@7.0.0-dev.20260122.2", "", { "os": "linux", "cpu": "arm" }, "sha512-ybrJVEuB9TmLWwdNl1ryUHeAm6KV3QcOKZUdfKhp6TjmuesOd1/2rdnGHmEcZlQDQt5+RtsCaxHWadvqDF1h3Q=="],
+
+    "@typescript/native-preview-linux-arm64": ["@typescript/native-preview-linux-arm64@7.0.0-dev.20260122.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-dMIOprNNvILRLKLlevs9fEE6Q6Bhikjv9OiQb3Sma3lcV/4lvh8DJ5hVKj2/aiGrK1000EC54UzwB6rLxnuw0w=="],
+
+    "@typescript/native-preview-linux-x64": ["@typescript/native-preview-linux-x64@7.0.0-dev.20260122.2", "", { "os": "linux", "cpu": "x64" }, "sha512-bbgb8a3dETxTTFUbSsCF7sSQ2oCsnyg7/HcFXi12TxdXscu1qod4/MxznBNOvwG/eYcrsLmI14k6BVRVSiGFoQ=="],
+
+    "@typescript/native-preview-win32-arm64": ["@typescript/native-preview-win32-arm64@7.0.0-dev.20260122.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-JxPwmsaV6wuijnOo4qg5aIMrzQarTNVHqUaVP5pijkon8Y6dCvJ+3lYNEe4E6baiiw1u3npUQY4l/cvx2RL1eQ=="],
+
+    "@typescript/native-preview-win32-x64": ["@typescript/native-preview-win32-x64@7.0.0-dev.20260122.2", "", { "os": "win32", "cpu": "x64" }, "sha512-TJH+sSn7vxcGvaSm+fhcpW//dfSGBZGHrxoy0edAbE7UpFf8ub/3cILL5V1pCsF7w3aLNNgVKRpUkowdUgYcPQ=="],
+
+    "allmark": ["allmark@1.0.0", "", { "bin": { "allmark": "dist/bin/index.mjs" } }, "sha512-Stsjcu2cLPBwPlbfba/iMaDGVhJcm6pYU8hNtyTIlYHhckBvCOtiHhyBujl6PltcFnpvG0VQpwyBXWjwY1e6ZA=="],
+
+    "balanced-match": ["balanced-match@1.0.2", "", {}, "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="],
+
+    "brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ=="],
+
+    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "javascript-natural-sort": ["javascript-natural-sort@0.7.1", "", {}, "sha512-nO6jcEfZWQXDhOiBtG2KvKyEptz7RVbpGP4vTD2hLBdmNQSsCiicO2Ioinv6UI4y9ukqnBpy+XZ9H6uLNgJTlw=="],
+
+    "js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="],
+
+    "jsesc": ["jsesc@3.1.0", "", { "bin": { "jsesc": "bin/jsesc" } }, "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA=="],
+
+    "lodash-es": ["lodash-es@4.17.23", "", {}, "sha512-kVI48u3PZr38HdYz98UmfPnXl2DXrpdctLrFLCd3kOx1xUkOmpFPx7gCWWM5MPkL/fD8zb+Ph0QzjGFs4+hHWg=="],
+
+    "minimatch": ["minimatch@9.0.5", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "parse-imports-exports": ["parse-imports-exports@0.2.4", "", { "dependencies": { "parse-statements": "1.0.11" } }, "sha512-4s6vd6dx1AotCx/RCI2m7t7GCh5bDRUtGNvRfHSP2wbBQdMi67pPe7mtzmgwcaQ8VKK/6IB7Glfyu3qdZJPybQ=="],
+
+    "parse-statements": ["parse-statements@1.0.11", "", {}, "sha512-HlsyYdMBnbPQ9Jr/VgJ1YF4scnldvJpJxCVx6KgqPL4dxppsWrJHCIIxQXMJrqGnsRkNPATbeMJ8Yxu7JMsYcA=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "prettier": ["prettier@3.8.1", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "opencode-miniterm",
+	"version": "1.0.0",
+	"description": "A small front-end terminal UI for OpenCode",
+	"main": "src/index.ts",
+	"bin": {
+		"ocmt": "src/index.ts"
+	},
+	"scripts": {
+		"dev": "bun src/index.ts",
+		"test": "bun test",
+		"check": "tsgo --noEmit"
+	},
+	"keywords": [
+		"opencode",
+		"terminal"
+	],
+	"author": "",
+	"license": "ISC",
+	"devDependencies": {
+		"@trivago/prettier-plugin-sort-imports": "^6.0.2",
+		"@types/bun": "latest",
+		"@typescript/native-preview": "7.0.0-dev.20260122.2",
+		"prettier": "^3.8.1",
+		"typescript": "^5.9.3"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"@opencode-ai/sdk": "^1.2.10",
+		"allmark": "^1.0.0"
+	}
+}

package/src/ansi.ts

@@ -0,0 +1,22 @@
+export const CLEAR_SCREEN = "\x1b[2J";
+export const CLEAR_FROM_CURSOR = "\x1b[0J";
+export const CLEAR_LINE = "\x1b[K";
+export const CLEAR_SCREEN_UP = "\x1b[2A";
+export const CURSOR_HOME = "\x1b[0G";
+export const CURSOR_HIDE = "\x1b[?25l";
+export const CURSOR_SHOW = "\x1b[?25h";
+export const CURSOR_UP = (lines: number) => `\x1b[${lines}A`;
+export const RESET = "\x1b[0m";
+export const BRIGHT_WHITE = "\x1b[97m";
+export const BRIGHT_BLACK = "\x1b[90m";
+export const RED = "\x1b[31m";
+export const GREEN = "\x1b[32m";
+export const BLUE = "\x1b[34m";
+export const CYAN = "\x1b[36m";
+export const BOLD_MAGENTA = "\x1b[1;35m";
+export const STRIKETHROUGH = "\x1b[9m";
+export const ANSI_CODE_PATTERN = /^\x1b\[[0-9;]*m/;
+
+export function stripAnsiCodes(str: string): string {
+	return str.replace(/\x1b\[[0-9;]*m/g, "");
+}

package/src/commands/agents.ts

@@ -0,0 +1,178 @@
+import type { Agent, OpencodeClient } from "@opencode-ai/sdk";
+import readline, { type Key } from "node:readline";
+import { config, saveConfig } from "../config";
+import { getActiveDisplay, writePrompt } from "../render";
+import type { Command } from "../types";
+
+interface AgentInfo {
+	id: string;
+	name: string;
+}
+
+let agentList: AgentInfo[] = [];
+let selectedAgentIndex = 0;
+let agentListLineCount = 0;
+let agentSearchString = "";
+let agentFilteredIndices: number[] = [];
+
+let command: Command = {
+	name: "/agents",
+	description: "List and select available agents",
+	run,
+	handleKey,
+	running: false,
+};
+
+export default command;
+
+async function run(client: OpencodeClient): Promise<void> {
+	const result = await client.app.agents();
+
+	if (result.error) {
+		throw new Error(
+			`Failed to fetch agents (${result.response.status}): ${JSON.stringify(result.error)}`,
+		);
+	}
+
+	agentList = (result.data || []).map((agent: Agent) => ({
+		id: agent.name,
+		name: agent.name,
+	}));
+
+	agentSearchString = "";
+	updateAgentFilter();
+
+	command.running = true;
+
+	renderAgentList();
+}
+
+async function handleKey(client: OpencodeClient, key: Key, str?: string) {
+	switch (key.name) {
+		case "up": {
+			if (selectedAgentIndex === 0) {
+				selectedAgentIndex = agentFilteredIndices.length - 1;
+			} else {
+				selectedAgentIndex--;
+			}
+			renderAgentList();
+			return;
+		}
+		case "down": {
+			if (selectedAgentIndex === agentFilteredIndices.length - 1) {
+				selectedAgentIndex = 0;
+			} else {
+				selectedAgentIndex++;
+			}
+			renderAgentList();
+			return;
+		}
+		case "escape": {
+			clearAgentList();
+			process.stdout.write("\x1b[?25h");
+			command.running = false;
+			agentList = [];
+			selectedAgentIndex = 0;
+			agentListLineCount = 0;
+			agentSearchString = "";
+			agentFilteredIndices = [];
+			readline.cursorTo(process.stdout, 0);
+			readline.clearScreenDown(process.stdout);
+			writePrompt();
+			return;
+		}
+		case "return": {
+			agentListLineCount++;
+			clearAgentList();
+			process.stdout.write("\x1b[?25h");
+			const selectedIndex = agentFilteredIndices[selectedAgentIndex];
+			const selected = selectedIndex !== undefined ? agentList[selectedIndex] : undefined;
+			command.running = false;
+			agentList = [];
+			selectedAgentIndex = 0;
+			agentListLineCount = 0;
+			agentSearchString = "";
+			agentFilteredIndices = [];
+			readline.cursorTo(process.stdout, 0);
+			readline.clearScreenDown(process.stdout);
+			if (selected) {
+				config.agentID = selected.id;
+				saveConfig();
+				const activeDisplay = await getActiveDisplay(client);
+				console.log(activeDisplay);
+				console.log();
+			}
+			writePrompt();
+			return;
+		}
+		case "backspace": {
+			agentSearchString = agentSearchString.slice(0, -1);
+			updateAgentFilter();
+			selectedAgentIndex = 0;
+			renderAgentList();
+			return;
+		}
+	}
+
+	if (str && str.length === 1) {
+		agentSearchString += str;
+		updateAgentFilter();
+		selectedAgentIndex = 0;
+		renderAgentList();
+		return;
+	}
+}
+
+function clearAgentList() {
+	process.stdout.write("\x1b[?25l");
+	if (agentListLineCount > 0) {
+		process.stdout.write(`\x1b[${agentListLineCount}A`);
+	}
+	readline.cursorTo(process.stdout, 0);
+	readline.clearScreenDown(process.stdout);
+}
+
+function renderAgentList(): void {
+	clearAgentList();
+
+	agentListLineCount = 0;
+	console.log("  \x1b[36;1mAvailable Agents\x1b[0m");
+	agentListLineCount++;
+
+	if (agentSearchString) {
+		console.log(`  \x1b[90mFilter: \x1b[0m\x1b[33m${agentSearchString}\x1b[0m`);
+		agentListLineCount++;
+	}
+
+	for (let i = 0; i < agentFilteredIndices.length; i++) {
+		const globalIndex = agentFilteredIndices[i]!;
+		const agent = agentList[globalIndex];
+		if (!agent) continue;
+		const isSelected = i === selectedAgentIndex;
+		const isActive = agent.id === config.agentID;
+		const prefix = isSelected ? "  >" : "   -";
+		const name = isSelected ? `\x1b[33;1m${agent.name}\x1b[0m` : agent.name;
+		const status = isActive ? " (active)" : "";
+
+		console.log(`${prefix} ${name}${status}`);
+		agentListLineCount++;
+	}
+}
+
+function updateAgentFilter(): void {
+	if (!agentSearchString) {
+		agentFilteredIndices = agentList.map((_, i) => i);
+	} else {
+		const search = agentSearchString.toLowerCase();
+		agentFilteredIndices = agentList
+			.map((agent, i) => ({ agent, index: i }))
+			.filter(({ agent }) => agent.name.toLowerCase().includes(search))
+			.map(({ index }) => index);
+	}
+	if (agentFilteredIndices.length > 0) {
+		selectedAgentIndex = agentFilteredIndices.indexOf(
+			agentList.findIndex((a) => a.id === config.agentID),
+		);
+		if (selectedAgentIndex === -1) selectedAgentIndex = 0;
+	}
+}