vibeOS for OpenCode

VIBE is a smart model router for OpenCode Desktop. It automatically selects and switches between brain, medium, and cheap model tiers based on the task at hand — expensive models handle orchestration while cost-effective models execute implementation work. No manual slot-picking needed.

The core is the VIBE autoswitcher: a decision engine that routes each request to the right tier based on context, enforcement policy, and session state. You stay in control via the trinity tool set, but the default workflow is zero-config.

Beyond routing, vibeOS tracks savings from tier-switching, enforces delegation policies, and provides real-time visibility through a live status footer and web dashboard.

Savings Categories

• Delegation savings — Estimated cost avoided by routing tasks to cheaper models.
• Cache savings — Cost avoided from scratchpad cache hits.

Both are summed in the live footer and persisted in `~/.claude/delegation-state.json` across sessions.

What It Does

• Smart delegation — Blocks direct write/edit on high-tier models and routes work to cheaper subagents
• Cost tracking — Tracks estimated savings from delegation events and cache hits, displayed in a live footer
• trinity commands — Runtime controls for model switching, enforcement toggles, audits, and diagnostics
• Flow enforcer — Validates write/edit patterns against project rules; optionally extracts TODOs/FIXMEs
• TDD enforcer — Auto-creates test skeletons for changed source files; strict mode makes TODO tests fail loudly
• Project guard — Protects AGENTS.md and README.md in every project with auto-regeneration
• Pattern learner — Detects recurring friction and routine patterns per project, surfaces via trinity patterns
• Stress mitigation — Detects user stress signals, adjusts tier routing, and injects protective prompts
• Model locking — Prevents auto-switching when model is changed in the OpenCode GUI (trinity lock)
• Report & audit — report-save, report-list, report-read, and research-audit tools
• Worker-to-Brain protocol — Delegates implementation tasks to cheaper subagents, synthesizes results in-chat
• Web dashboard — Real-time status, savings, stress gauge, and controls via browser
• TUI sidebar — Plugin status and controls via OpenCode sidebar plugin
• Blackbox decision engine — Dialogue trajectory tracking with loop prevention, pivot detection, and outcome tracking

Install

npm (Recommended)

npm install vibeOS

Register in ~/.config/opencode/opencode.json:

"plugins": [
  { "id": "vibeOS", "path": "node_modules/vibeOS/src/index.js" }
]

Local Plugin File

Copy the plugin and lib files to ~/.config/opencode/plugins/. See the repository for the complete file list.

Register in ~/.config/opencode/opencode.json:

"plugins": [
  { "id": "vibeOS", "path": "~/.config/opencode/plugins/vibeOS.js" }
]

Restart OpenCode Desktop. The plugin auto-creates its configuration on first run.

trinity Commands

Footer Format

Typical output footer:

— [model route] | VibeTheOG: <total> saved <arrow> —

The footer shows model split, cumulative savings, stress gauge, and trend arrow.

Web Dashboard

npm run build:dashboard   # Build the SPA
npm run dashboard         # Start server on http://127.0.0.1:3333

Displays model split, savings, session history, stress gauge, trinity controls, reports, and blackbox state with SSE push updates every 1.5s.

Environment Variables

Without an API token, the plugin runs in local-only mode with all algorithms bundled locally.

Runtime Model Slots

Tier configuration in ~/.claude/model-tiers.json:

Use trinity set brain|medium|cheap or trinity rebuild to configure.

Known Limitations

• OpenCode runtime behavior can vary by version.
• Some test suite tests may fail due to policy semantic changes rather than actual breakage.
• Savings displayed are estimates, not billing data.