A powerful terminal interface for discovering and managing OpenCode extensions
Community Project: This is a community-driven project and is not an official SST/Opencode initiative.
Beyond Demo: This has evolved beyond a UI demo and now includes real installation capabilities, persistent storage, and extension lifecycle management.
OpenCode Extensions TUI is a comprehensive terminal application that lets you discover, install, and manage OpenCode extensions right from your command line. No browser needed!
Perfect for developers who live in the terminal and want complete control over their OpenCode extension ecosystem with real installation capabilities and persistent state management.
- Installation Capabilities - Install extensions via npm, bash scripts, or direct download
- Persistent Storage - SQLite database tracks installation status and metadata
- Skills Support - Install and manage skill bundles from the OpenCode ecosystem
- Configuration Editor - Full-featured modal editor with JSONC support for OpenCode config
- Dual Keybind Modes - Toggle between OC (OpenCode-style) and NVIM (vim-style) navigation
- Multiple Installation Methods - Supports npm packages, bash scripts, GitHub agents, and skill bundles
- Interactive Installation Flows - Modal dialogs for installation options and script previews
- Lightning Fast - Instant search and navigation
- Beautiful Interface - Clean, responsive terminal UI
- Smart Search - Find extensions by name, description, or category
- Organized Browsing - Navigate through curated categories
- Keyboard Only - Full control without touching your mouse
- Rich Information - See downloads, stars, and detailed descriptions
- Live Updates - Refresh to get the latest extension data
- Status Tracking - Installation/uninstallation status with error handling
You need Bun installed (it's like npm but way faster):
curl -fsSL https://bun.sh/install | bash# Clone the repository
git clone https://github.com/IgorWarzocha/Opencode-Extensions-TUI.git
cd Opencode-Extensions-TUI
# Install dependencies (takes ~10 seconds)
bun install
# Launch the TUI!
bun devThat's it! You're now browsing extensions in your terminal.
| Key | What it does |
|---|---|
↑ ↓ |
Move up/down through extensions |
← → or Shift+Tab Tab |
Switch between categories |
Enter |
Install selected extension |
o |
Open details view |
u or Delete |
Uninstall selected extension |
/ or Ctrl+f |
Start searching |
r |
Refresh extension data |
Ctrl+e |
Open configuration editor |
Home / End |
Jump to top/bottom of list |
Ctrl+x then q |
Quit the application |
Ctrl+c or Ctrl+q |
Quit immediately |
Press Ctrl+g to toggle between OC and NVIM modes.
| Key | What it does |
|---|---|
j k |
Move up/down through extensions |
h l |
Switch between categories |
g g |
Jump to top of list |
Shift+g |
Jump to bottom of list |
Enter or i |
Install selected extension |
o |
Open details view |
u |
Uninstall selected extension |
/ |
Start searching |
r |
Refresh extension data |
Ctrl+e |
Open configuration editor |
q or Ctrl+c |
Quit the application |
Press / to search:
- Start typing to filter extensions instantly
Enterto apply searchEscapeto cancel and go back
Press Enter on any extension to install:
- NPM Extensions: Choose between local or global installation scope
- Bash Scripts: Preview installation scripts before execution
- GitHub Agents: Install directly from GitHub repositories
- Skill Bundles: Select specific skills to install from bundles
- Drop Extensions: Direct file-based installation
Press Ctrl+e to open the configuration editor modal with 8 sections:
- Core Settings - Theme, username, default agent, share mode
- Plugins - Manage installed plugins
- Agents - Configure agent settings
- Providers - Enable/disable LLM providers
- MCP Servers - Model Context Protocol server configuration
- Skills - Manage installed skills (local/global scope)
- Keybindings - Edit keyboard shortcuts
- Raw JSON - Direct JSONC editing with validation
Use Ctrl+Up/Down to navigate sections in the config editor.
- All - Browse all extensions
- Featured - Curated featured extensions
- Plugins - OpenCode plugins and integrations
- Agents - AI agents and specialized workflows
- Commands - Custom commands and command extensions
- Tools - Standalone CLI tools and utilities
- Skills - Skill bundles for OpenCode
- Themes - Visual themes and color schemes
- Bundles - Complete configuration packages
- List View - Browse all extensions with key info
- Details View - Press
ofor full extension details - Search View - Press
/to find specific extensions - Installation Modals - Interactive dialogs for installation options
- Configuration Editor - Press
Ctrl+efor full config management
Each extension card shows:
- Name & Author - Who made it
- Stars & Downloads - Community popularity
- Category - What type of extension it is
- Description - What it does
- Status - Available or marked as installed
Note: Extension data is loaded from local SQLite database. Installation status is persisted in the database.
Want to contribute or modify the TUI?
# Development with hot reload
bun dev
# Run directly
bun run src/index.tsxBuilt with React 19, OpenTUI, and TypeScript. See AGENTS.md for development guidelines.
Found a bug or have an idea?
Currently in Peer Review Stage - We welcome community feedback on UX consistency, keyboard shortcuts, and workflow improvements!
- Read CONTRIBUTING.md - Guidelines for contributions and current focus areas
- Check FAQ.md - Detailed workflows and technical documentation
- Open an Issue - Report bugs or suggest improvements
- Fork and create a Pull Request - Submit your changes
- Join the OpenCode community!
Made for the terminal-loving developer community
If you like this, give it a star on GitHub!