opencode-plugin-ui

Build OpenCode plugin TUI experiences with toasts and session prompts.

1|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/pantheon-org/opencode-plugins --skill opencode-plugin-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opencode-plugin-ui
Source: https://github.com/pantheon-org/opencode-plugins/tree/main/.opencode/skills/opencode-plugin-ui
Command: npx skills add https://github.com/pantheon-org/opencode-plugins --skill opencode-plugin-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode plugin developers often struggle to provide responsive, user-friendly feedback and prompts during complex workflows. This skill provides a framework for integrating TUI elements, toasts, and session-driven prompts to create interactive plugins.

Core Features & Use Cases

  • Toast notifications to display status, success, and error messages during tool execution.
  • User messaging via session prompts with noReply to communicate with users without triggering AI responses.
  • Prompt manipulation through appendPrompt and helper APIs to guide user input and maintain context.
  • Use Case: Create a plugin that guides a user step-by-step through a data-cleaning task, with live progress updates and inline suggestions.

Quick Start

Install the OpenCode SDK in your plugin workspace and begin scaffolding a new plugin that integrates the UI features. Then run and test the plugin locally to verify toasts, prompts, and prompt suggestions in a test session.

Frequently Asked Questions about opencode-plugin-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I show toast notifications in an OpenCode plugin?

You can display toast notifications in OpenCode plugins using the client.tui API to show status, success, and error messages during tool execution. This Skill provides TypeScript examples for implementing these real-time UI feedback elements.

How do I send messages to users without triggering an AI response?

You can send messages to users without triggering an AI response by using session prompts with the noReply option. This method communicates contextual guidance during interactive plugin workflows without polling the language model.

Can I manipulate user input prompts programmatically in a TUI plugin?

Yes, you can manipulate user input programmatically in a TUI plugin using the appendPrompt and helper APIs. This allows you to guide user input, maintain context, and provide inline suggestions within the OpenCode ecosystem.

What is the best way to build interactive step-by-step workflows in OpenCode?

The best way to build interactive workflows is combining client.tui and client.session APIs for real-time feedback and contextual prompts. This framework enables step-by-step task guidance with live progress updates and inline suggestions.

Do I need TypeScript to develop TUI plugins for OpenCode?

TypeScript is required to implement the TUI features provided by this Skill, as the solution utilizes TypeScript examples and best practices. You also need the OpenCode SDK installed in your plugin workspace to scaffold and test locally.