opencode-agent-arcadeAn OpenCode TUI plugin that turns agent wait time into a tiny runner game.
1
40
5 in 7 days
27.9
Multi-signal model
2 months ago
2026-05-25
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-agent-arcade@0.2.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-agent-arcade@0.2.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-agent-arcadeopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
Agent Arcade is an experimental OpenCode TUI plugin that turns agent wait time into tiny terminal arcade games.
Open it while the agent works, play a quick game, watch tool events fly through the overlay, and approve pending permissions without leaving the game.

Games
- Runner: jump over terminal gremlins while agent events become in-game floaters.
- Tetris: stack pieces while waiting for the agent to finish.
The overlay includes a native game selector, so /agent-arcade and ctrl+shift+g can open a game or close the active overlay.
Install
Add the plugin to your OpenCode TUI config at .opencode/tui.json:
{
"$schema": "https://opencode.ai/tui.json",
"plugin": ["opencode-agent-arcade"]
}
Then restart OpenCode. TUI plugins are loaded when OpenCode starts.
Optional auto-start opens the last selected game when an agent becomes busy:
{
"$schema": "https://opencode.ai/tui.json",
"plugin": [["opencode-agent-arcade", { "autoStart": true }]]
}
You can also choose a specific auto-start game or randomize it:
{
"$schema": "https://opencode.ai/tui.json",
"plugin": [["opencode-agent-arcade", { "autoStart": true, "autoStartGame": "random" }]]
}
autoStartGame accepts last, runner, tetris, or random.
Usage
/agent-arcade: open the game selector, or close the active game overlay./agent-arcade-auto: toggle auto-start and persist it locally.ctrl+shift+g: open the game selector, or close the active game overlay.- Game selector: use arrows to navigate,
enterto select, andescto close.
Runner controls:
space,up, ork: jump.r: reset after game over.m: return to the game selector.qoresc: quit the overlay.a: approve the currently pending OpenCode permission once.
Tetris controls:
leftorh: move left.rightorl: move right.downorj: soft drop.up,k, orspace: rotate.c: hold the current piece.d: hard drop.p: pause or resume.r: reset.m: return to the game selector.qoresc: quit.a: approve the currently pending OpenCode permission once.
The a binding only replies to an active OpenCode permission prompt with once. Review what the agent is asking for before approving.
Local Development
This repo uses Bun and publishes the TUI plugin source directly.
bun install
bun run typecheck
For local OpenCode usage from this repo, .opencode/tui.json points at packages/opencode-plugin/src/tui.tsx.
Status
This is an alpha plugin. It is ready for people to try, but expect rough edges while OpenCode's TUI plugin surface keeps evolving.