opencode TUI Utils

English | 한국어 | 日本語 | 中文

Essential TUI commands missing from opencode. Install once, stop editing JSON by hand.

This project is built to grow command by command. Each utility exposes data the TUI already holds but lacks a quick slash-command shortcut for (pattern established by opencode issue #10494).

Preview

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. See command ideas →

Quick Start

Install from npm with opencode's plugin installer:

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:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["opencode-tui-utils"]
}

Restart opencode and run:

/disconnect

To enable OpenCode's launch-gated research tools from the TUI, use:

/lsp-toggle
/websearch-toggle
/tool-status

The toggle commands update your shell profile and show a restart notice. Open a new terminal and restart OpenCode for the changed tools to appear in the model's tool list.

Commands

Available

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 servers and the experimental lsp tool env together. Requires terminal/OpenCode restart.
/websearch-toggle	—	Toggle websearch env for future OpenCode launches. Requires terminal/OpenCode restart. No API key needed.
/plugin-list	—	Show installed plugins and their activation state.
/tool-status	—	Show launch-gated OpenCode tool status for websearch, experimental lsp, and LSP servers.
/tool-env	—	Advanced menu for launch-time env vars used by websearch and the experimental lsp tool. Requires terminal/OpenCode restart.
/export-chat	—	Export the current session chat to a markdown file in the project directory.
/session-diff	—	List files changed in the current session.
/session-todos	—	Show pending todos for the current session.

Ideas & Contributions Welcome

These are verified gaps where the TUI already holds the data but offers no slash-command shortcut. Pick one and open an issue.

Command	Problem it Solves
/provider-list	"What's connected right now?" — read-only counterpart to /disconnect
/session-info	"How many messages in this session? What's the status?"

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:

{
  "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.

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.

Tool Status Notes

/lsp-toggle changes both parts needed for full LSP support:

• opencode.json lsp: true/false for LSP servers
• OPENCODE_EXPERIMENTAL_LSP_TOOL=1 for the experimental LLM tool

The equivalent manual launch flag is:

OPENCODE_EXPERIMENTAL_LSP_TOOL=true opencode

/websearch-toggle manages OpenCode's built-in websearch launch flag. OpenCode's docs state that no API key is required; it connects to Exa's hosted MCP service without authentication. The equivalent manual launch flag is:

OPENCODE_ENABLE_EXA=1 opencode

Use /tool-status to see the current config, shell profile, and live environment state. These are OpenCode built-in tools, not skills or user-configured MCP servers.

Use /tool-env only when you want an advanced single menu for both launch-time env vars. For everyday use, prefer /lsp-toggle and /websearch-toggle.

Adding More Utilities

New commands are added as separate plugin modules under src/plugins/ and registered from src/index.tsx.

src/
  core/
    api-wrapper.ts      Shared wrapper around the opencode TUI API
  plugins/
    disconnect.tsx      Provider disconnect command
    lsp-toggle.tsx      LSP toggle command
    websearch-toggle.tsx Web search toggle command
    tool-status.tsx     Tool status command
    your-command.tsx    Add new utilities here
  index.tsx             Public plugin entry point

Want to build one? Check the Command Ideas list in CONTRIBUTING.md. Each idea exposes data the TUI already has but lacks a slash-command shortcut for.

Minimal command shape:

/** @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:

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

git clone https://github.com/Blue-B/opencode-tui-utils.git
cd opencode-tui-utils
npm install
npm run build

Local source-file testing:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["/absolute/path/to/opencode-tui-utils/src/plugins/disconnect.tsx"]
}

Restart opencode after changing tui.json.

Contributing

Issues and PRs are welcome. Please keep changes small and focused. See CONTRIBUTING.md before adding a new command.

License

MIT — 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.