Skip to content

Repository files navigation

OpenSpec Task Progress for OpenCode

opencode-openspec-task-tui automatically selects the active OpenSpec change for the current project and adds a read-only OpenCode sidebar. It shows global and per-section task progress and keeps accordion preferences separate by project and change.

CleanShot 2026-08-01 at 13 09 53@2x

Requirements

  • Node.js 22.13 or newer
  • OpenCode with a compatible TUI plugin API
  • The openspec CLI available on PATH
  • An OpenSpec project opened as the current OpenCode project

Install from npm

Install the package:

npm install opencode-openspec-task-tui

Add its TUI entry to ~/.config/opencode/tui.json:

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

Restart OpenCode after changing the configuration.

Use a local compiled bundle

From this repository, install dependencies and build the bundle:

pnpm install
pnpm build

Point OpenCode at the resulting JavaScript file with an absolute path:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["/absolute/path/to/opencode-openspec-task-tui/dist/tui.js"]
}

Restart OpenCode. Keep the bundle in this package directory so its OpenCode, OpenTUI, and Solid peer dependencies remain resolvable.

About

OpenCode TUI sidebar showing live task progress for the active OpenSpec change

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages