Project overview

How the OpenCode Plugins repository and its packages are organized.

This repository contains focused OpenCode v2 TUI plugins and the documentation site that explains how to install and use them. The plugins extend the terminal interface; they do not replace models, prompts, or OpenCode server configuration.

Packages

Package	Purpose	Published entrypoints
`@mynameistito/opencode-force-input`	Interrupt an active run and submit the current prompt with `Ctrl+Enter` or `Ctrl+Return`.	`./tui`
`@mynameistito/opencode-usage-limits`	Show supported provider usage windows and balances in the sidebar and prompt footer.	`./tui`, `./schema`

The package READMEs and the plugin guides and usage guide are the detailed user-facing references. Package versions are released independently.

Repository layout

packages/
  opencode-force-input/   Force Input plugin source, tests, and package metadata
  opencode-usage-limits/  Usage Limits plugin source, tests, schema, and examples
apps/
  web/                    Blume documentation site and Cloudflare deployment
.changeset/               Pending package release and documentation notes

The root package.json defines the Bun workspace and common checks. Each package owns its runtime dependencies, build, tests, and published files. The website content is sourced from apps/web/docs/ and its release history is generated from GitHub releases.

Technology and compatibility

OpenCode v2 TUI plugin API provides keybindings, session context, and UI slots.
TypeScript is used for plugin implementations; Usage Limits uses Effect for provider runtime workflows.
Bun workspaces manage installation and run the repository’s scripts.
Blume builds the documentation site, including searchable and agent-oriented documentation outputs.
Alchemy deploys the static site to Cloudflare Workers assets.

The plugins target OpenCode v2 and are distributed through npm. Consult each package’s README for current installation instructions, configuration, provider support, and troubleshooting.

Start here

Force Input: keybinding behavior and configuration.
Usage Limits: providers, credentials, display, and configuration.
Architecture: runtime boundaries and data flow.
Development and releases: local commands, checks, and deployment.
Source repository