https://github.com/pedropombeiro/opencode-terminal-progress
OpenCode plugin that shows agent progress in terminal tabs (iTerm2, WezTerm, Windows Terminal)
https://github.com/pedropombeiro/opencode-terminal-progress
iterm2 opencode opencode-plugin wezterm
Last synced: 29 days ago
JSON representation
OpenCode plugin that shows agent progress in terminal tabs (iTerm2, WezTerm, Windows Terminal)
- Host: GitHub
- URL: https://github.com/pedropombeiro/opencode-terminal-progress
- Owner: pedropombeiro
- License: mit
- Created: 2026-03-06T21:39:43.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-03-11T15:51:47.000Z (about 1 month ago)
- Last Synced: 2026-03-11T19:13:52.822Z (about 1 month ago)
- Topics: iterm2, opencode, opencode-plugin, wezterm
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/opencode-terminal-progress
- Size: 61.5 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# opencode-terminal-progress
An [OpenCode](https://opencode.ai) plugin that shows agent progress in your terminal tab using
[OSC 9;4](https://iterm2.com/documentation-escape-codes.html) progress reporting.
## Supported terminals
| Terminal | Detection |
| --------------------------------------------------------- | ------------------------------------------------------- |
| [iTerm2](https://iterm2.com) | `TERM_PROGRAM=iTerm.app`, `LC_TERMINAL`, `ITERM_SESSION_ID` |
| [WezTerm](https://wezfurlong.org/wezterm/) | `TERM_PROGRAM=WezTerm`, `WEZTERM_EXECUTABLE` |
| [Windows Terminal](https://github.com/microsoft/terminal) | `WT_SESSION` |
The plugin automatically detects which terminal is in use and becomes a no-op if none of the above
are found. tmux passthrough is handled transparently when `$TMUX` is set.
## Progress states
| Agent state | Progress indicator |
| ------------------- | ------------------ |
| Busy | Indeterminate |
| Idle | Cleared |
| Error | Error (red) |
| Waiting for input | Paused at 50% |
## Installation
```bash
npm install opencode-terminal-progress
```
Add to your `~/.config/opencode/opencode.json`:
```json
{
"plugin": ["opencode-terminal-progress"]
}
```
## License
[MIT](LICENSE)