Free Usage Monitor

opencode-free-usage-monitor

OpenCode TUI plugin showing free model API usage in the sidebar

Actively maintained

GitHub stars

Monthly installs

37 in 7 days

Composite scoreSCORE

27.9

Multi-signal model

Last commit

2 months ago

2026-05-28

Install and configure

opencode.json

Writes to this project's opencode.json — applies to this repository only.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-free-usage-monitor@1.0.0"]
}

Writes to ~/.config/opencode/opencode.json — applies to every project.

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-free-usage-monitor@1.0.0"]
}

opencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.

README.md

OpenCode TUI sidebar plugin that displays free model API usage (count, limit, countdown to next reset) in real-time.

Monitors requests to free-tier models (Big Pickle, DeepSeek-V4-Flash-Free, Qwen3.6 Plus Free, Nemotron 3 Super Free)
Displays current/total usage with a progress bar
Session-specific request count
Countdown timer to next available request
Retry-after countdown when rate-limited
Persistent usage tracking across sessions via KV storage

Add to your opencode.json or tui.json plugin array:

{
  "plugin": ["opencode-free-usage-monitor"]
}

MIT