Skip to content
    ↑↓ select↵ openesc close
    English中文
    AaronSR-54

    Usage Viewer

    v1.0.7Other
    opencode-usage-viewer

    OpenCode Go usage plugin showing rolling, weekly and monthly usage

    Actively maintained
    #opencode#opencode-plugin#usage
    GitHub reponpm pageHomepage
    GitHub stars

    0

    Monthly installs

    52

    17 in 7 days

    Composite scoreSCORE

    25.2

    Multi-signal model

    Last commit

    3 months ago

    2026-05-08

    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-usage-viewer@1.0.7"]
}

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

    README.md
    View original→

    OpenCode Go plugin that displays token usage (rolling, weekly and monthly) in two ways:

    1. Tool - Run /usage at any time to see current usage
    2. Automatic toast - On session start, shows a toast with current usage

    Requirements

    • OpenCode Go installed and configured
    • Environment variables:
      • OPENCODE_GO_WORKSPACE_ID - Your workspace ID (found in the opencode URL)
      • OPENCODE_GO_AUTH_COOKIE - Authentication cookie (auth cookie from opencode.ai)

    How to get the variables

    WORKSPACE_ID: Found in the URL when you access your workspace:

    https://opencode.ai/workspace/[YOUR_ID_IS_HERE]/go

    AUTH_COOKIE: You need to extract the auth cookie from your browser while logged into opencode.ai. In Chrome/Edge you can find it in DevTools > Application > Cookies.

    Installation

    npm install -g opencode-usage-viewer

    The postinstall script automatically adds opencode-usage-viewer to your global opencode config (~/.config/opencode/opencode.json or opencode.jsonc). After installing, restart opencode.

    How it works

    /usage Tool

    Tool screenshot

    > /usage

  OpenCode GO Usage
------------------------

ROLLING   ████████░░░░░░░░░░░░░░░░  33.0%  reset 6h 12m
WEEKLY    ██░░░░░░░░░░░░░░░░░░░░░░   8.0%  reset 3d 0h
MONTHLY   ░░░░░░░░░░░░░░░░░░░░░░░░   0.0%  reset 12d 0h

    Session Toast

    Toast screenshot

    When a session starts, a toast automatically appears showing:

    OpenCode GO Usage
------------------------

ROLLING   ████████░░░░░░░░░░░░░░░░  33.0%  reset 6h 12m
WEEKLY    ██░░░░░░░░░░░░░░░░░░░░░░   8.0%  reset 3d 0h
MONTHLY   ░░░░░░░░░░░░░░░░░░░░░░░░   0.0%  reset 12d 0h

    Uninstall

    npm uninstall -g opencode-usage-viewer

    Also remove opencode-usage-viewer from the plugin array in your opencode config (~/.config/opencode/opencode.json or opencode.jsonc).

    Project structure

    opencode-usage-viewer/
  index.js            # Main plugin (exports OpenCodeUsagePlugin)
  postinstall.js      # Adds plugin entry to opencode config
  package.json        # npm package config
  README.md           # This file
  screenshot-tool.png # Tool output screenshot
  screenshot-toast.png # Toast notification screenshot

    Troubleshooting

    Toast not appearing

    • Verify that environment variables are set
    • Check opencode console for errors

    Tool not working

    • Make sure you are logged into opencode.ai
    • Verify the auth cookie has not expired

    Fetch errors

    • May be a network issue or credentials problem