@skwid138/opencode-tui

Lipstick for your OpenCode TUI.

@skwid138/opencode-tui is a configurable OpenCode TUI plugin that replaces the home screen logo and prompt placeholders with friendlier defaults. Use it as-is, customize the ASCII rows and inline colors, swap prompt suggestions, or disable either section independently.

Install

npm install @skwid138/opencode-tui

Add the TUI entry to your OpenCode plugin configuration using the package's TUI export:

{
  "plugins": ["@skwid138/opencode-tui/tui"]
}

Usage

Zero config

Use the default JustVibes logo and default prompt placeholders:

{
  "plugins": ["@skwid138/opencode-tui/tui"]
}

Logo builder

Use the logo builder to generate custom logo.rows config: https://skwid138.github.io/opencode-logo-builder/.

Plugin options are registered as a tuple: ["@skwid138/opencode-tui/tui", { config }].

Disable sections

Disable only the logo:

{
  "plugins": [
    ["@skwid138/opencode-tui/tui", { "logo": false }]
  ]
}

Disable only the prompt override:

{
  "plugins": [
    ["@skwid138/opencode-tui/tui", { "prompt": false }]
  ]
}

Disable both sections:

{
  "plugins": [
    ["@skwid138/opencode-tui/tui", { "logo": false, "prompt": false }]
  ]
}

Custom prompts

{
  "plugins": [
    [
      "@skwid138/opencode-tui/tui",
      {
        "prompt": {
          "placeholders": {
            "normal": [
              "Build a dashboard for my team",
              "Refactor this component",
              "Help me debug this error"
            ],
            "shell": [
              "List files by size",
              "Show current git status"
            ]
          }
        }
      }
    ]
  ]
}

Custom logo rows

Each row contains literal pre-rendered ASCII text segments. Segment color is an inline 3- or 6-digit hex string including #.

{
  "plugins": [
    [
      "@skwid138/opencode-tui/tui",
      {
        "logo": {
          "rows": [
            {
              "segments": [
                { "text": "Open", "color": "#5DBDB3" },
                { "text": "Code", "color": "#F8B4C4" }
              ]
            }
          ]
        }
      }
    ]
  ]
}

Options reference

Option	Type	Default	Description
logo	false | LogoConfig	default logo	Set to false to leave home_logo untouched.
logo.rows	Array<{ segments: Array<{ text: string; color: string }> }>	JustVibes ASCII art	Logo rows rendered as horizontal text segments. Segment colors must match #RGB or #RRGGBB. Empty arrays fall back to defaults.
prompt	false | PromptConfig	default prompt	Set to false to leave home_prompt untouched.
prompt.placeholders.normal	string[]	11 default ideas	Suggestions for normal prompt mode. Empty arrays fall back to defaults.
prompt.placeholders.shell	string[]	3 default shell ideas	Suggestions for shell prompt mode. Empty arrays fall back to defaults.

Invalid sections are isolated: a bad logo config falls back to the default logo without breaking prompt customization, and a bad prompt config falls back without breaking the logo. Validation never throws; warnings are logged and surfaced through the OpenCode toast API when available.

Development

Install dependencies:

npm install

Run tests:

npm test

Run tests with coverage:

npm run test:coverage

Type-check:

npm run typecheck

Build the package:

npm run build

The build emits ESM artifacts and declaration files into dist/.