OpenCode · Desktop overlay

Agent Overlay for OpenCode

A sleek, transparent desktop overlay that automatically triggers a beautiful Warp Speed particle animation when using OpenCode — any provider (xAI/Grok, and more).

Read the full guide View on GitHub

✨ Features

Auto show / hide

Overlay appears on generation and hides when every concurrent OpenCode session finishes (any-active multi-process).

11 particle styles

Default Hyperspace plus Signal waves, Datastream, Orbit, Aurora, and more — reactive start kick, idle shimmer, token heartbeat, completion bloom.

Ambient, no focus steal

Transparent field stays out of the way — generation does not grab IDE focus; Settings still can when you open them.

No extra API key

Works with your existing OpenCode setup (any provider, including Grok / xAI).

Python bridge

Log detect (OpenCode ≥1.15 + legacy), claimed multi-process log tail, SQLite token poll, quiet TUI (no [EVENT] spam).

Token flow

Floating +N chips ride the stream; per-style alpha; intensity tracks live tokens.

Project cwd preserved

oc / shim keep your current folder so OpenCode opens the project you launched from.

Windows & macOS

Script-relative tool root (no hard-coded install path) · PowerShell + shell installers · tray + autostart.

🛠 Tech stack

Tauri 2
Svelte 5 + TypeScript
Rust + tiny_http
Python 3 bridge
Canvas 2D particles
Windows & macOS

⚠️ Actively developed. Contributions and feedback are welcome on GitHub.

Preview

Settings panel with animation styles — Settings — 11 styles (incl. Signal), alpha, speed, Test warp

Warp particles while generating — Generating — full-bleed particles (no focus steal)

Quick start

Windows

Clone repo → build overlay → install-shim.ps1 → install-autostart.ps1 → run opencode from your project folder. Tool root is script-relative (or AGENT_TOOL_ROOT).

macOS

Build .app → ./install-shim.sh → ./start-overlay.sh → run opencode from your project.

Open setup guide (VI / EN)