opencode-tui-utils 1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,156 @@
+# Contributing to opencode-tui-utils
+
+Thank you for taking the time to improve `opencode-tui-utils`.
+
+This package is intentionally small. A good contribution should feel native to opencode's TUI, solve one clear problem, and avoid changing how opencode itself works.
+
+## Before You Start
+
+- Check whether the feature already exists in opencode.
+- Check existing issues and pull requests for similar work.
+- Keep the first version of a command small enough to review and test manually.
+- Avoid new runtime dependencies unless they are clearly necessary.
+
+## Project Layout
+
+```text
+src/
+  core/
+    api-wrapper.ts      Shared wrapper around the opencode TUI API
+  plugins/
+    disconnect.tsx      Current provider disconnect command
+    your-feature.tsx    New commands belong here
+  index.tsx             Public plugin entry point
+```
+
+## Adding A Command
+
+Create a file in `src/plugins/`:
+
+```typescript
+/** @jsxImportSource @opentui/solid */
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { createWrappedAPI } from "../core/api-wrapper"
+
+const plugin: TuiPluginModule & { id: string } = {
+  id: "opencode-tui-utils.your-feature",
+  async tui(rawApi) {
+    const api = createWrappedAPI(rawApi)
+
+    api.keymap.registerLayer({
+      commands: [
+        {
+          name: "opencode-tui-utils.your-feature",
+          title: "Your Feature",
+          category: "Utility",
+          namespace: "palette",
+          slashName: "your-command",
+          async run() {
+            api.ui.toast({
+              title: "Ready",
+              message: "Your command ran successfully.",
+            })
+          },
+        },
+      ],
+    })
+  },
+}
+
+export default plugin
+```
+
+Register it in `src/index.tsx`:
+
+```typescript
+import yourPlugin from "./plugins/your-feature"
+
+const plugins: TuiPluginModule[] = [disconnectPlugin, yourPlugin]
+```
+
+## API Wrapper
+
+Use `createWrappedAPI(rawApi)` in plugin files instead of calling the raw opencode API directly. This keeps API-specific changes isolated to `src/core/api-wrapper.ts` when possible.
+
+Example:
+
+```typescript
+const api = createWrappedAPI(rawApi)
+
+api.ui.toast({
+  variant: "success",
+  message: "Done",
+})
+```
+
+## KV Storage
+
+The wrapper currently supports `get`, `set`, `getJSON`, and `setJSON`.
+
+```typescript
+await api.kv.setJSON("my-feature.settings", { enabled: true })
+
+const settings = await api.kv.getJSON<{ enabled: boolean }>(
+  "my-feature.settings",
+)
+```
+
+The current opencode TUI KV API does not expose delete. If you need deletion semantics, store an updated object without the removed field.
+
+## Local Testing
+
+Type-check the package:
+
+```bash
+npm install
+npm run build
+```
+
+To test a command in opencode before publishing, reference the source file from `~/.config/opencode/tui.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["/absolute/path/to/opencode-tui-utils/src/plugins/your-feature.tsx"]
+}
+```
+
+Then restart opencode and run the slash command.
+
+## Pull Requests
+
+- Describe the user-facing problem the change solves.
+- Include manual testing steps.
+- Update `README.md` if the command is user-facing.
+- Update localized README files when changing install, compatibility, or command behavior.
+- Keep unrelated formatting and refactors out of feature PRs.
+
+Suggested PR title format:
+
+```text
+feat: add /your-command
+fix: handle missing auth file in /disconnect
+docs: clarify plugin installation
+```
+
+## Command Scope
+
+Good fits for this package:
+
+| Idea | Why |
+| --- | --- |
+| Provider quick switch | Small TUI-native provider utility. |
+| Session favorites | Helps navigate opencode sessions without changing core behavior. |
+| Config sanity checks | Useful local diagnostics with clear output. |
+
+Poor fits:
+
+| Idea | Why |
+| --- | --- |
+| Agent orchestration | Better handled by dedicated workflow plugins. |
+| Prompt packs | Better as opencode commands or separate repositories. |
+| Provider backends | Should be maintained as provider-specific plugins. |
+
+## License
+
+By contributing, you agree that your contribution will be released under the MIT License.

package/LICENSE

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

@@ -0,0 +1,140 @@
+# opencode TUI Utils
+
+[English](./README.md) | [한국어](./README.ko.md) | 日本語 | [中文](./README.zh.md)
+
+<p align="center">
+  <img src="docs/banner.png" alt="opencode-tui-utils" width="860">
+</p>
+
+[![npm version](https://img.shields.io/npm/v/opencode-tui-utils?style=flat-square)](https://www.npmjs.com/package/opencode-tui-utils)
+[![Build](https://img.shields.io/github/actions/workflow/status/Blue-B/opencode-tui-utils/test.yml?branch=main&style=flat-square)](https://github.com/Blue-B/opencode-tui-utils/actions)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+[opencode](https://opencode.ai) のTUIで使う小さなユーティリティ集です。最初のコマンドは、接続済みプロバイダーを安全に解除する `/disconnect` です。
+
+このプロジェクトは、コマンドを1つずつ追加して育てる前提で構成されています。各ユーティリティは、opencode TUI内の明確な問題を1つ解決し、レビューとテストがしやすい形に保ちます。
+
+## プレビュー
+
+<p align="center">
+  <img src="docs/preview-command.png" alt="/disconnect コマンド選択" width="600">
+</p>
+
+<p align="center">
+  <img src="docs/preview-result.png" alt="プロバイダー切断完了" width="600">
+</p>
+
+実際の画面ではopencodeのTUI dialogコンポーネントを使います。外部スクリプトではなく、opencodeのコマンドパレットとdialogの流れの中で動作します。
+
+## なぜ使うのか
+
+| 必要なこと | 得られるもの |
+| --- | --- |
+| 1つのプロバイダーだけ安全に削除 | TUIで選んだ認証項目だけを削除できます |
+| JSONの手動編集を避ける | `~/.local/share/opencode/auth.json`を直接編集する必要がありません |
+| トークンを表示しない | プロバイダー名と認証タイプだけを表示し、トークン値は出力しません |
+| 小さな機能を追加しやすい | 共通ローダーとAPIラッパーで新しいユーティリティを追加しやすくしています |
+
+## クイックスタート
+
+opencodeのプラグインインストーラーでnpmからインストールします。
+
+```bash
+opencode plugin opencode-tui-utils
+```
+
+このコマンドはパッケージをインストールし、opencodeの設定を更新します。設定を手動で管理する場合は、`~/.config/opencode/tui.json`に次の項目があることを確認してください。
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["opencode-tui-utils"]
+}
+```
+
+opencodeを再起動して実行します。
+
+```text
+/disconnect
+```
+
+## コマンド
+
+| コマンド | エイリアス | 説明 |
+| --- | --- | --- |
+| `/disconnect` | `/dc` | 接続済みプロバイダーを1つ選び、opencodeの認証ストレージから削除します。新しいセションを開くと変更が反映されます。 |
+| `/lsp-toggle` | — | `~/.config/opencode/opencode.json` の `lsp` 設定を true/false に切り替えます。opencodeの再起動が必要です。 |
+
+## `/disconnect` の動作
+
+`/disconnect` はopencodeの認証ファイルを読み、トップレベルのプロバイダーキーを一覧表示し、選択したプロバイダーだけを削除して同じファイルへ保存します。
+
+例:
+
+```json
+{
+  "github": { "type": "copilot-free" },
+  "anthropic": { "type": "api-key" },
+  "openai": { "type": "api-key" }
+}
+```
+
+`github`を選択した場合、トップレベルの`github`キーだけが削除されます。`anthropic`や`openai`など他のプロバイダーは残ります。
+
+> **注意:** opencodeはセション開始時に認証ファイルを読み込みます。切断後は新しいopencodeウィンドウまたはセションを開くと、更新されたプロバイダー一覧が反映されます。
+
+出発点は [opencode issue #10494](https://github.com/anomalyco/opencode/issues/10494) で話されていたプロバイダー解除の不便さでした。
+
+## データ保存
+
+| データ | 場所 | 説明 |
+| --- | --- | --- |
+| プロバイダー認証 | `~/.local/share/opencode/auth.json` | 選択したプロバイダーキーだけを削除します |
+| カスタム認証パス | `OPENCODE_AUTH_PATH=/path/to/auth.json` | 標準以外の場所を使う場合の上書きです |
+| プラグインソース | npm package / opencode plugin cache | `/disconnect`は外部サービスへリクエストしません |
+
+`/disconnect`はネットワークリクエストを送らず、トークン値をコピーしたりUIに出力したりしません。
+
+## ユーティリティの追加
+
+新しいコマンドは `src/plugins/` 配下に個別のプラグインモジュールとして追加し、`src/index.tsx`から登録します。
+
+```text
+src/
+  core/
+    api-wrapper.ts      opencode TUI APIの共通ラッパー
+  plugins/
+    disconnect.tsx      プロバイダー解除コマンド
+    lsp-toggle.tsx      LSP切り替えコマンド
+    your-command.tsx    新しいユーティリティの追加先
+  index.tsx             公開プラグインエントリ
+```
+
+opencode TUI APIを使う場合は `createWrappedAPI(rawApi)` を通してください。opencodeのプラグインAPIが変わった場合の修正箇所を減らすためです。
+
+## 開発
+
+```bash
+git clone https://github.com/Blue-B/opencode-tui-utils.git
+cd opencode-tui-utils
+npm install
+npm run build
+```
+
+## 互換性
+
+テスト済みの環境です。
+
+| ツール | バージョン |
+| --- | --- |
+| opencode | 1.14.46 |
+
+このパッケージはopencodeのTUI Plugin APIを使うため、peer dependencyとして`@opencode-ai/plugin >=1.14.42`を指定しています。
+
+## コントリビューション
+
+IssueとPRを歓迎します。新しいコマンドを追加する前に[CONTRIBUTING.md](CONTRIBUTING.md)を確認してください。小さく、目的がはっきりした変更を歓迎します。
+
+## ライセンス
+
+MIT

package/README.ko.md

@@ -0,0 +1,191 @@
+# opencode TUI Utils
+
+[English](./README.md) | 한국어 | [日本語](./README.ja.md) | [中文](./README.zh.md)
+
+<p align="center">
+  <img src="docs/banner.png" alt="opencode-tui-utils" width="860">
+</p>
+
+[![npm version](https://img.shields.io/npm/v/opencode-tui-utils?style=flat-square)](https://www.npmjs.com/package/opencode-tui-utils)
+[![Build](https://img.shields.io/github/actions/workflow/status/Blue-B/opencode-tui-utils/test.yml?branch=main&style=flat-square)](https://github.com/Blue-B/opencode-tui-utils/actions)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+[opencode](https://opencode.ai) TUI에서 자주 필요한 작업을 작은 명령어로 추가하는 플러그인 패키지입니다. 첫 기능은 연결된 프로바이더를 안전하게 해제하는 `/disconnect` 명령입니다.
+
+이 프로젝트는 명령어를 하나씩 확장할 수 있도록 구성되어 있습니다. 각 유틸리티는 opencode TUI 안에서 한 가지 문제를 명확하게 해결하고, 검토와 테스트가 쉬운 형태를 유지하는 것을 기준으로 합니다.
+
+## 미리보기
+
+<p align="center">
+  <img src="docs/preview-command.png" alt="/disconnect 명령 선택" width="600">
+</p>
+
+<p align="center">
+  <img src="docs/preview-result.png" alt="프로바이더 해제 완료" width="600">
+</p>
+
+실제 화면은 opencode의 TUI dialog 컴포넌트를 사용합니다. 별도 스크립트를 실행하는 방식이 아니라 opencode 안의 명령 팔레트와 dialog 흐름에서 자연스럽게 동작합니다.
+
+## 왜 필요한가요?
+
+| 필요 | 제공 가치 |
+| --- | --- |
+| 프로바이더 하나만 안전하게 제거 | TUI에서 선택한 인증 항목 하나만 삭제합니다 |
+| 직접 JSON 수정 방지 | `~/.local/share/opencode/auth.json`을 손으로 열어 수정하지 않아도 됩니다 |
+| 토큰 노출 방지 | 프로바이더 이름과 인증 타입만 표시하고 토큰 값은 출력하지 않습니다 |
+| 기능 확장 | 공용 플러그인 로더와 API 래퍼로 새 유틸리티를 추가하기 쉽습니다 |
+
+## 시작하기
+
+opencode의 플러그인 설치 명령으로 npm에서 설치합니다.
+
+```bash
+opencode plugin opencode-tui-utils
+```
+
+이 명령은 패키지를 설치하고 opencode 설정을 갱신합니다. 직접 설정을 관리한다면 `~/.config/opencode/tui.json`에 아래 항목이 있어야 합니다.
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["opencode-tui-utils"]
+}
+```
+
+opencode를 재시작한 뒤 실행합니다.
+
+```text
+/disconnect
+```
+
+## 명령어
+
+| 명령어 | 별칭 | 설명 |
+| --- | --- | --- |
+| `/disconnect` | `/dc` | 연결된 프로바이더 중 하나를 선택해 opencode 인증 저장소에서 제거합니다. 새 세션을 열어야 변경 사항이 반영됩니다. |
+| `/lsp-toggle` | — | `~/.config/opencode/opencode.json`의 `lsp` 설정을 true/false로 전환합니다. opencode 재시작 필요. |
+
+## `/disconnect` 동작 방식
+
+`/disconnect`는 opencode 인증 파일을 읽고, 최상위 프로바이더 키 목록을 보여준 뒤, 사용자가 선택한 프로바이더 하나만 제거한 상태로 같은 파일을 다시 저장합니다.
+
+예시 인증 구조:
+
+```json
+{
+  "github": { "type": "copilot-free" },
+  "anthropic": { "type": "api-key" },
+  "openai": { "type": "api-key" }
+}
+```
+
+여기서 `github`를 선택하면 최상위 `github` 키만 제거됩니다. `anthropic`, `openai` 같은 다른 프로바이더 항목은 그대로 유지됩니다.
+
+> **참고:** opencode는 세션 시작 시 인증 파일을 읽습니다. 해제 후에는 새로운 opencode 창이나 세션을 열어야 업데이트된 프로바이더 목록이 반영됩니다.
+
+처음 시작점은 [opencode issue #10494](https://github.com/anomalyco/opencode/issues/10494)에서 다뤄진 프로바이더 해제 불편함이었습니다.
+
+## 데이터 저장
+
+| 데이터 | 위치 | 설명 |
+| --- | --- | --- |
+| 프로바이더 인증 | `~/.local/share/opencode/auth.json` | 선택한 프로바이더 키만 이 파일에서 제거합니다 |
+| 사용자 지정 인증 경로 | `OPENCODE_AUTH_PATH=/path/to/auth.json` | 기본 위치가 아닌 경우 사용할 수 있습니다 |
+| 플러그인 소스 | npm 패키지 / opencode plugin cache | `/disconnect`는 외부 서비스에 요청하지 않습니다 |
+
+`/disconnect`는 네트워크 요청을 보내지 않고, 토큰 값을 복사하거나 UI에 출력하지 않습니다.
+
+## 유틸리티 확장 방법
+
+새 명령어는 `src/plugins/` 아래에 별도 플러그인 모듈로 추가하고, `src/index.tsx`에서 등록합니다.
+
+```text
+src/
+  core/
+    api-wrapper.ts      opencode TUI API 공용 래퍼
+  plugins/
+    disconnect.tsx      프로바이더 해제 명령어
+    lsp-toggle.tsx      LSP 전환 명령어
+    your-command.tsx    새 유틸리티 추가 위치
+  index.tsx             공개 플러그인 진입점
+```
+
+최소 명령어 형태:
+
+```typescript
+/** @jsxImportSource @opentui/solid */
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { createWrappedAPI } from "../core/api-wrapper"
+
+const plugin: TuiPluginModule & { id: string } = {
+  id: "opencode-tui-utils.your-command",
+  async tui(rawApi) {
+    const api = createWrappedAPI(rawApi)
+
+    api.keymap.registerLayer({
+      commands: [
+        {
+          name: "opencode-tui-utils.your-command",
+          title: "Your Command",
+          category: "Utility",
+          namespace: "palette",
+          slashName: "your-command",
+          async run() {
+            api.ui.toast({ message: "Command ran successfully." })
+          },
+        },
+      ],
+    })
+  },
+}
+
+export default plugin
+```
+
+그 다음 `src/index.tsx`에 등록합니다.
+
+```typescript
+import yourCommand from "./plugins/your-command"
+
+const plugins: TuiPluginModule[] = [disconnectPlugin, lspTogglePlugin, yourCommand]
+```
+
+opencode TUI API를 사용할 때는 `createWrappedAPI(rawApi)`를 거치도록 합니다. opencode 플러그인 API가 바뀌었을 때 수정 지점을 줄이기 위한 구조입니다.
+
+## 개발
+
+```bash
+git clone https://github.com/Blue-B/opencode-tui-utils.git
+cd opencode-tui-utils
+npm install
+npm run build
+```
+
+로컬 소스 파일 테스트 예시:
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["/absolute/path/to/opencode-tui-utils/src/plugins/disconnect.tsx"]
+}
+```
+
+`tui.json` 변경 후에는 opencode를 재시작해야 합니다.
+
+## 호환성
+
+테스트한 환경입니다.
+
+| 도구 | 버전 |
+| --- | --- |
+| opencode | 1.14.46 |
+
+이 패키지는 opencode의 TUI Plugin API를 사용하므로 peer dependency로 `@opencode-ai/plugin >=1.14.42`를 선언합니다.
+
+## 기여
+
+이슈와 PR은 환영합니다. 새 명령어를 추가하기 전에는 [CONTRIBUTING.md](CONTRIBUTING.md)를 확인해 주세요. 작고 명확한 변경을 선호합니다.
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,199 @@
+# opencode TUI Utils
+
+English | [한국어](./README.ko.md) | [日本語](./README.ja.md) | [中文](./README.zh.md)
+
+<p align="center">
+  <img src="docs/banner.png" alt="opencode-tui-utils" width="860">
+</p>
+
+[![npm version](https://img.shields.io/npm/v/opencode-tui-utils?style=flat-square)](https://www.npmjs.com/package/opencode-tui-utils)
+[![Build](https://img.shields.io/github/actions/workflow/status/Blue-B/opencode-tui-utils/test.yml?branch=main&style=flat-square)](https://github.com/Blue-B/opencode-tui-utils/actions)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+Small native-feeling TUI utilities for [opencode](https://opencode.ai). The first command adds a safe provider disconnect flow, so you can remove one connected provider without editing `auth.json` by hand.
+
+This project is built to grow command by command. Each utility should solve one focused opencode TUI problem and stay easy to review, test, and remove.
+
+## Preview
+
+<p align="center">
+  <img src="docs/preview-command.png" alt="/disconnect command selection" width="600">
+</p>
+
+<p align="center">
+  <img src="docs/preview-result.png" alt="Provider disconnected confirmation" width="600">
+</p>
+
+The command uses opencode's own TUI dialog components, so it appears inside the same command palette and dialog flow instead of launching a separate script.
+
+## Why use opencode TUI Utils
+
+| Need | What you get |
+| --- | --- |
+| Remove one provider safely | Select a provider in the TUI and remove only that auth entry |
+| Avoid manual JSON edits | No need to open or hand-edit `~/.local/share/opencode/auth.json` |
+| Keep tokens private | Provider names and auth types are shown, token values are never printed |
+| Add more small commands | Shared plugin loader and API wrapper make new utilities straightforward |
+
+## Quick Start
+
+Install from npm with opencode's plugin installer:
+
+```bash
+opencode plugin opencode-tui-utils
+```
+
+That command installs the package and updates your opencode config. If you manage the config manually, make sure `~/.config/opencode/tui.json` includes:
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["opencode-tui-utils"]
+}
+```
+
+Restart opencode and run:
+
+```text
+/disconnect
+```
+
+## Commands
+
+| Command | Alias | Description |
+| --- | --- | --- |
+| `/disconnect` | `/dc` | Pick one connected provider and remove it from opencode auth storage. Open a new session to reflect the change. |
+| `/lsp-toggle` | — | Toggle `lsp: true/false` in `~/.config/opencode/opencode.json`. Requires opencode restart. |
+
+## How `/disconnect` works
+
+`/disconnect` reads your opencode auth file, lists the provider keys, and rewrites the same file after removing the one provider you selected.
+
+Example auth shape:
+
+```json
+{
+  "github": { "type": "copilot-free" },
+  "anthropic": { "type": "api-key" },
+  "openai": { "type": "api-key" }
+}
+```
+
+If you select `github`, only the top-level `github` key is removed. Other provider entries stay untouched.
+
+> **Note:** opencode reads the auth file at session start. After disconnecting, open a new opencode window or session to see the updated provider list.
+
+This started from the provider disconnect pain point discussed in [opencode issue #10494](https://github.com/anomalyco/opencode/issues/10494).
+
+## Data Storage
+
+| Data | Location | Notes |
+| --- | --- | --- |
+| Provider auth | `~/.local/share/opencode/auth.json` | The selected provider key is removed from this file |
+| Custom auth path | `OPENCODE_AUTH_PATH=/path/to/auth.json` | Optional override for non-standard setups |
+| Plugin source | npm package / opencode plugin cache | No external service is contacted by `/disconnect` |
+
+`/disconnect` does not send network requests, copy token values, or print token values to the UI.
+
+## Adding More Utilities
+
+New commands are added as separate plugin modules under `src/plugins/` and registered from `src/index.tsx`.
+
+```text
+src/
+  core/
+    api-wrapper.ts      Shared wrapper around the opencode TUI API
+  plugins/
+    disconnect.tsx      Provider disconnect command
+    lsp-toggle.tsx      LSP toggle command
+    your-command.tsx    Add new utilities here
+  index.tsx             Public plugin entry point
+```
+
+Minimal command shape:
+
+```typescript
+/** @jsxImportSource @opentui/solid */
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { createWrappedAPI } from "../core/api-wrapper"
+
+const plugin: TuiPluginModule & { id: string } = {
+  id: "opencode-tui-utils.your-command",
+  async tui(rawApi) {
+    const api = createWrappedAPI(rawApi)
+
+    api.keymap.registerLayer({
+      commands: [
+        {
+          name: "opencode-tui-utils.your-command",
+          title: "Your Command",
+          category: "Utility",
+          namespace: "palette",
+          slashName: "your-command",
+          async run() {
+            api.ui.toast({ message: "Command ran successfully." })
+          },
+        },
+      ],
+    })
+  },
+}
+
+export default plugin
+```
+
+Then register it in `src/index.tsx`:
+
+```typescript
+import yourCommand from "./plugins/your-command"
+
+const plugins: TuiPluginModule[] = [disconnectPlugin, lspTogglePlugin, yourCommand]
+```
+
+Use `createWrappedAPI(rawApi)` for opencode TUI APIs. It keeps API-specific changes easier to isolate when opencode updates its plugin API.
+
+## Tips
+
+### Switching model variants (xhigh / high / max)
+
+Use `Ctrl + T` in the TUI to cycle through reasoning variants for the current model. To switch models entirely, use `Ctrl + X` then `M`, or type `/models`.
+
+## Development
+
+```bash
+git clone https://github.com/Blue-B/opencode-tui-utils.git
+cd opencode-tui-utils
+npm install
+npm run build
+```
+
+Local source-file testing:
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["/absolute/path/to/opencode-tui-utils/src/plugins/disconnect.tsx"]
+}
+```
+
+Restart opencode after changing `tui.json`.
+
+## Compatibility
+
+Tested with:
+
+| Tool | Version |
+| --- | --- |
+| opencode | 1.14.46 |
+
+The package declares `@opencode-ai/plugin >=1.14.42` as a peer dependency because it uses opencode's TUI Plugin API.
+
+## Contributing
+
+Issues and PRs are welcome. Please keep changes small and focused. See [CONTRIBUTING.md](CONTRIBUTING.md) before adding a new command.
+
+## License
+
+[MIT](LICENSE) — Blue-B © 2026
+
+You are free to use, modify, and distribute this project, including for commercial purposes. The only requirement is to keep the copyright notice and license text included in any copies or substantial portions.

package/README.zh.md

@@ -0,0 +1,140 @@
+# opencode TUI Utils
+
+[English](./README.md) | [한국어](./README.ko.md) | [日本語](./README.ja.md) | 中文
+
+<p align="center">
+  <img src="docs/banner.png" alt="opencode-tui-utils" width="860">
+</p>
+
+[![npm version](https://img.shields.io/npm/v/opencode-tui-utils?style=flat-square)](https://www.npmjs.com/package/opencode-tui-utils)
+[![Build](https://img.shields.io/github/actions/workflow/status/Blue-B/opencode-tui-utils/test.yml?branch=main&style=flat-square)](https://github.com/Blue-B/opencode-tui-utils/actions)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+面向 [opencode](https://opencode.ai) TUI 的小型工具集。第一个命令是 `/disconnect`，用于安全地断开一个已连接的 provider，不需要手动编辑 `auth.json`。
+
+这个项目按“一个命令解决一个问题”的方式扩展。每个工具都应该聚焦于一个 opencode TUI 场景，并保持容易审查、测试和移除。
+
+## 预览
+
+<p align="center">
+  <img src="docs/preview-command.png" alt="/disconnect 命令选择" width="600">
+</p>
+
+<p align="center">
+  <img src="docs/preview-result.png" alt="Provider 断开确认" width="600">
+</p>
+
+实际界面使用 opencode 的 TUI dialog 组件，所以它在 opencode 的命令面板和 dialog 流程中运行，而不是额外启动脚本。
+
+## 为什么使用它
+
+| 需求 | 提供的能力 |
+| --- | --- |
+| 安全移除一个 provider | 在 TUI 中选择并只删除对应认证项 |
+| 避免手动编辑 JSON | 不需要直接打开 `~/.local/share/opencode/auth.json` |
+| 避免 token 暴露 | 只显示 provider 名称和认证类型，不输出 token 值 |
+| 方便继续扩展 | 共享插件加载器和 API wrapper 让新增工具更简单 |
+
+## 快速开始
+
+使用 opencode 的插件安装器从 npm 安装：
+
+```bash
+opencode plugin opencode-tui-utils
+```
+
+这个命令会安装包并更新 opencode 配置。如果你手动管理配置，请确保 `~/.config/opencode/tui.json` 包含：
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["opencode-tui-utils"]
+}
+```
+
+重启 opencode，然后运行：
+
+```text
+/disconnect
+```
+
+## 命令
+
+| 命令 | 别名 | 说明 |
+| --- | --- | --- |
+| `/disconnect` | `/dc` | 选择一个已连接的 provider，并从 opencode 的认证存储中移除。需要打开新会话才能看到变更。 |
+| `/lsp-toggle` | — | 切换 `~/.config/opencode/opencode.json` 中的 `lsp` 设置。需要重启 opencode。 |
+
+## `/disconnect` 如何工作
+
+`/disconnect` 会读取 opencode 的认证文件，列出顶层 provider key，然后只删除你选择的那一个 provider，并把结果写回同一个文件。
+
+示例：
+
+```json
+{
+  "github": { "type": "copilot-free" },
+  "anthropic": { "type": "api-key" },
+  "openai": { "type": "api-key" }
+}
+```
+
+如果选择 `github`，只会删除顶层的 `github` key。`anthropic`、`openai` 等其他 provider 会保持不变。
+
+> **注意：** opencode 在会话启动时读取认证文件。断开连接后，需要打开新的 opencode 窗口或会话才能看到更新后的 provider 列表。
+
+它最初来自 [opencode issue #10494](https://github.com/anomalyco/opencode/issues/10494) 中提到的 provider 断开问题。
+
+## 数据存储
+
+| 数据 | 位置 | 说明 |
+| --- | --- | --- |
+| Provider 认证 | `~/.local/share/opencode/auth.json` | 只从这里删除选择的 provider key |
+| 自定义认证路径 | `OPENCODE_AUTH_PATH=/path/to/auth.json` | 用于非默认数据目录 |
+| 插件源码 | npm package / opencode plugin cache | `/disconnect` 不会访问外部服务 |
+
+`/disconnect` 不会发送网络请求，不会复制 token 值，也不会把 token 值显示在 UI 中。
+
+## 添加更多工具
+
+新命令作为单独的插件模块放在 `src/plugins/` 下，并从 `src/index.tsx` 注册。
+
+```text
+src/
+  core/
+    api-wrapper.ts      opencode TUI API 的共享 wrapper
+  plugins/
+    disconnect.tsx      Provider 断开命令
+    lsp-toggle.tsx      LSP 切换命令
+    your-command.tsx    新工具放在这里
+  index.tsx             公开插件入口
+```
+
+使用 opencode TUI API 时请通过 `createWrappedAPI(rawApi)`。这样当 opencode 插件 API 变化时，更新位置会更集中。
+
+## 开发
+
+```bash
+git clone https://github.com/Blue-B/opencode-tui-utils.git
+cd opencode-tui-utils
+npm install
+npm run build
+```
+
+## 兼容性
+
+已测试环境：
+
+| 工具 | 版本 |
+| --- | --- |
+| opencode | 1.14.46 |
+
+这个包使用 opencode 的 TUI Plugin API，因此将 `@opencode-ai/plugin >=1.14.42` 声明为 peer dependency。
+
+## 贡献
+
+欢迎 issue 和 PR。添加新命令前请先阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。更推荐小而清晰的改动。
+
+## 许可证
+
+MIT

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "opencode-tui-utils",
+  "version": "1.0.0",
+  "description": "Add /disconnect command to opencode - safely disconnect providers without editing auth.json",
+  "main": "src/index.tsx",
+  "type": "module",
+  "scripts": {
+    "build": "tsc --noEmit",
+    "dev": "tsc --watch",
+    "test": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "src",
+    "docs",
+    "README.md",
+    "README.*.md",
+    "CONTRIBUTING.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "opencode",
+    "tui",
+    "plugin",
+    "disconnect",
+    "provider",
+    "auth",
+    "copilot"
+  ],
+  "author": "Blue-B <source_vs@naver.com>",
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.14.42",
+    "@opentui/solid": ">=0.2.6"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "1.14.46",
+    "@opentui/solid": "^0.2.6",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Blue-B/opencode-tui-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Blue-B/opencode-tui-utils/issues"
+  },
+  "homepage": "https://github.com/Blue-B/opencode-tui-utils#readme"
+}

package/src/core/api-wrapper.ts

@@ -0,0 +1,98 @@
+/**
+ * OpenCode TUI API Wrapper
+ * 
+ * Keeps opencode TUI API calls behind a small local layer so API-specific
+ * changes are easier to isolate.
+ */
+
+import type { TuiPluginApi } from "@opencode-ai/plugin/tui"
+
+export interface WrappedAPI {
+  keymap: ReturnType<typeof createKeymapAPI>
+  ui: ReturnType<typeof createUIAPI>
+  kv: ReturnType<typeof createKVAPI>
+}
+
+/**
+ * Keymap API wrapper for slash commands and palette commands.
+ */
+export function createKeymapAPI(api: TuiPluginApi) {
+  return {
+    registerLayer: (config: Parameters<typeof api.keymap.registerLayer>[0]) => {
+      return api.keymap.registerLayer(config)
+    },
+  }
+}
+
+/**
+ * UI API wrapper for dialogs and toasts.
+ */
+export function createUIAPI(api: TuiPluginApi) {
+  return {
+    dialog: {
+      replace: (component: Parameters<typeof api.ui.dialog.replace>[0]) => {
+        return api.ui.dialog.replace(component)
+      },
+      clear: () => {
+        return api.ui.dialog.clear()
+      },
+    },
+    toast: (options: Parameters<typeof api.ui.toast>[0]) => {
+      return api.ui.toast(options)
+    },
+    // Re-export UI components used by plugins.
+    DialogSelect: api.ui.DialogSelect,
+    DialogConfirm: api.ui.DialogConfirm,
+    DialogAlert: api.ui.DialogAlert,
+  }
+}
+
+/**
+ * KV storage wrapper for future commands that need persistence.
+ */
+export function createKVAPI(api: TuiPluginApi) {
+  return {
+    get: async (key: string): Promise<string | undefined> => {
+      try {
+        return api.kv.get<string | undefined>(key)
+      } catch (error) {
+        console.error(`Failed to get KV key "${key}":`, error)
+        return undefined
+      }
+    },
+    set: async (key: string, value: string): Promise<void> => {
+      try {
+        api.kv.set(key, value)
+      } catch (error) {
+        console.error(`Failed to set KV key "${key}":`, error)
+      }
+    },
+    getJSON: async <T = unknown>(key: string): Promise<T | undefined> => {
+      try {
+        const value = api.kv.get<string | undefined>(key)
+        return value ? JSON.parse(value) : undefined
+      } catch (error) {
+        console.error(`Failed to parse JSON from KV key "${key}":`, error)
+        return undefined
+      }
+    },
+    setJSON: async <T = unknown>(key: string, value: T): Promise<void> => {
+      try {
+        api.kv.set(key, JSON.stringify(value))
+      } catch (error) {
+        console.error(`Failed to set JSON to KV key "${key}":`, error)
+      }
+    },
+  }
+}
+
+/**
+ * Main wrapper used by plugins.
+ */
+export function createWrappedAPI(api: TuiPluginApi): WrappedAPI {
+  return {
+    keymap: createKeymapAPI(api),
+    ui: createUIAPI(api),
+    kv: createKVAPI(api),
+  }
+}

package/src/index.tsx

@@ -0,0 +1,28 @@
+/**
+ * OpenCode TUI Utils - Plugin Loader
+ */
+
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui"
+import disconnectPlugin from "./plugins/disconnect"
+import lspTogglePlugin from "./plugins/lsp-toggle"
+
+const plugins: TuiPluginModule[] = [disconnectPlugin, lspTogglePlugin]
+
+export async function initializePlugins(...args: Parameters<TuiPluginModule["tui"]>) {
+  for (const plugin of plugins) {
+    try {
+      await plugin.tui(...args)
+    } catch (error) {
+      console.error(`Failed to initialize plugin:`, error)
+    }
+  }
+}
+
+const mainPlugin: TuiPluginModule & { id: string } = {
+  id: "opencode-tui-utils",
+  async tui(...args: Parameters<TuiPluginModule["tui"]>) {
+    await initializePlugins(...args)
+  },
+}
+
+export default mainPlugin

package/src/plugins/disconnect.tsx

@@ -0,0 +1,113 @@
+/** @jsxImportSource @opentui/solid */
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { homedir } from "node:os"
+import { join } from "node:path"
+import { readFile, writeFile } from "node:fs/promises"
+import { createWrappedAPI } from "../core/api-wrapper"
+
+function getAuthPath() {
+  if (process.env.OPENCODE_AUTH_PATH) return process.env.OPENCODE_AUTH_PATH
+
+  const dataHome = process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share")
+  return join(dataHome, "opencode", "auth.json")
+}
+
+async function loadAuth() {
+  try {
+    const content = await readFile(getAuthPath(), "utf-8")
+    return JSON.parse(content) as Record<string, { type: string }>
+  } catch (error) {
+    console.error("Failed to load auth:", error)
+    return null
+  }
+}
+
+async function saveAuth(data: Record<string, unknown>) {
+  try {
+    await writeFile(getAuthPath(), JSON.stringify(data, null, 2))
+  } catch (error) {
+    console.error("Failed to save auth:", error)
+    throw error
+  }
+}
+
+const plugin: TuiPluginModule & { id: string } = {
+  id: "opencode-tui-utils.disconnect",
+  async tui(rawApi) {
+    const api = createWrappedAPI(rawApi)
+    const { DialogSelect, DialogAlert } = api.ui
+
+    api.keymap.registerLayer({
+      commands: [
+        {
+          name: "opencode-tui-utils.disconnect",
+          title: "Disconnect Provider",
+          category: "Provider",
+          namespace: "palette",
+          slashName: "disconnect",
+          slashAliases: ["dc"],
+          async run() {
+            const data = await loadAuth()
+            if (!data) {
+              api.ui.dialog.replace(() => (
+                <DialogAlert
+                  title="Error"
+                  message="Could not read authentication file."
+                />
+              ))
+              return
+            }
+
+            const providers = Object.keys(data)
+            if (providers.length === 0) {
+              api.ui.toast({
+                title: "No providers",
+                message: "No providers connected.",
+              })
+              return
+            }
+
+            const options = providers.map((p) => ({
+              title: `${p} (${data[p]?.type ?? "unknown"})`,
+              value: p,
+            }))
+
+            api.ui.dialog.replace(() => (
+              <DialogSelect
+                title="Select provider to disconnect"
+                options={options}
+                onSelect={(option) => {
+                  if (!option) return
+
+                  void (async () => {
+                    const nextData = { ...data }
+                    delete nextData[option.value]
+
+                    try {
+                      await saveAuth(nextData)
+                      api.ui.dialog.clear()
+                      api.ui.toast({
+                        variant: "success",
+                        title: "Disconnected",
+                        message: `Removed ${option.value}. Open a new session to reflect the change.`,
+                      })
+                    } catch {
+                      api.ui.dialog.replace(() => (
+                        <DialogAlert
+                          title="Error"
+                          message="Could not update authentication file."
+                        />
+                      ))
+                    }
+                  })()
+                }}
+              />
+            ))
+          },
+        },
+      ],
+    })
+  },
+}
+
+export default plugin

package/src/plugins/lsp-toggle.tsx

@@ -0,0 +1,96 @@
+/**
+ * /lsp-toggle
+ *
+ * Toggles the `lsp` field in ~/.config/opencode/opencode.json between true/false.
+ * This controls whether opencode starts Language Server Protocol support.
+ *
+ * Important: opencode reads config at startup. Changing the JSON file does NOT
+ * hot-reload the setting. You must restart opencode after toggling for the
+ * change to take effect.
+ *
+ * Usage:
+ *   /lsp-toggle        Toggle LSP on/off
+ */
+
+/** @jsxImportSource @opentui/solid */
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { homedir } from "node:os"
+import { join } from "node:path"
+import { readFile, writeFile } from "node:fs/promises"
+import { createWrappedAPI } from "../core/api-wrapper"
+
+/** Resolve opencode.json path. Honors OPENCODE_CONFIG_DIR if set. */
+function getConfigPath() {
+  if (process.env.OPENCODE_CONFIG_DIR) {
+    return join(process.env.OPENCODE_CONFIG_DIR, "opencode.json")
+  }
+  return join(homedir(), ".config", "opencode", "opencode.json")
+}
+
+async function loadConfig() {
+  try {
+    const content = await readFile(getConfigPath(), "utf-8")
+    return JSON.parse(content) as Record<string, unknown>
+  } catch {
+    // If file is missing or unreadable, start with an empty object.
+    return {}
+  }
+}
+
+async function saveConfig(data: Record<string, unknown>) {
+  await writeFile(getConfigPath(), JSON.stringify(data, null, 2))
+}
+
+const plugin: TuiPluginModule & { id: string } = {
+  id: "opencode-tui-utils.lsp-toggle",
+  async tui(rawApi) {
+    const api = createWrappedAPI(rawApi)
+
+    api.keymap.registerLayer({
+      commands: [
+        {
+          name: "opencode-tui-utils.lsp-toggle",
+          title: "Toggle LSP",
+          category: "Config",
+          namespace: "palette",
+          slashName: "lsp-toggle",
+          async run() {
+            const config = await loadConfig()
+            const isEnabled = !!config.lsp
+            const DialogConfirm = api.ui.DialogConfirm
+
+            api.ui.dialog.replace(() => (
+              <DialogConfirm
+                title="Toggle LSP"
+                message={
+                  isEnabled
+                    ? "LSP is currently enabled. Disable it?"
+                    : "LSP is currently disabled. Enable it?"
+                }
+                onConfirm={async () => {
+                  config.lsp = !isEnabled
+                  await saveConfig(config)
+                  api.ui.dialog.clear()
+
+                  const nextEnabled = !isEnabled
+                  api.ui.toast({
+                    variant: nextEnabled ? "success" : "info",
+                    title: nextEnabled ? "LSP Enabled" : "LSP Disabled",
+                    message: nextEnabled
+                      ? "LSP turned on. Restart opencode to apply."
+                      : "LSP turned off. Restart opencode to apply.",
+                  })
+                }}
+                onCancel={() => {
+                  api.ui.dialog.clear()
+                }}
+              />
+            ))
+          },
+        },
+      ],
+    })
+  },
+}
+
+export default plugin