Skip to content
    ↑↓ select↵ openesc close
    English中文
    edso404

    Context Progress

    v1.0.1UI & Themes
    @oh-my-sidebar/opencode-context-progress

    OpenCode TUI sidebar plugin for context usage progress

    Actively maintained
    #opencode#opencode-plugin#sidebar#context
    GitHub reponpm pageHomepage
    GitHub stars

    0

    Monthly installs

    175

    42 in 7 days

    Composite scoreSCORE

    32.1

    Multi-signal model

    Last commit

    1 month ago

    2026-07-13

    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": ["@oh-my-sidebar/opencode-context-progress@1.0.1"]
}

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

    README.md
    View original→

    CI Release License

    Monorepo for OpenCode TUI sidebar plugins, published as scoped npm packages under @oh-my-sidebar/.

    Plugins extend the OpenCode sidebar with real-time session telemetry — context window usage, token breakdowns by model, and session costs — rendered as native TUI components.

    Packages

    Package Version Description
    @oh-my-sidebar/opencode-context-progress npm Context usage progress bar with color-coded warnings
    @oh-my-sidebar/opencode-session-tokens npm Per-model token usage breakdown with collapsible view

    Architecture

    @oh-my-sidebar (monorepo)
├── packages/
│   ├── context-progress    # Progress bar + cost display
│   └── session-tokens      # Token breakdown by model
└── (published individually to npm)

    Each plugin is an independent npm package that hooks into the OpenCode TUI plugin system via the sidebar_content slot. They share a common dependency stack:

    • Runtime: Solid.js (reactive UI in terminal)
    • UI framework: OpenTUI (@opentui/core + @opentui/solid)
    • Plugin API: @opencode-ai/plugin/tui
    • Build: TypeScript + tsup (ESM only)

    Plugins are registered in the OpenCode TUI configuration (tui.jsonc) and rendered as native sidebar widgets with full terminal interactivity — no DOM, no webview, no external processes.

    Prerequisites

    • Node.js >= 22
    • pnpm >= 11.9 (install via corepack enable && corepack prepare pnpm@11.9.0 --activate)
    • OpenCode >= 1.4.3 (for running the plugins)

    Getting Started

    pnpm install
pnpm build

    Development

    pnpm dev         # watch mode — rebuilds on source changes
pnpm lint        # biome check . (formatting + linting)
pnpm format      # biome check --write . (auto-fix)
pnpm typecheck   # tsc --noEmit across all packages
pnpm test        # vitest (per-package)
pnpm check       # lint + typecheck in one pass

    Adding a Plugin

    # Copy the template package:
cp -r packages/context-progress packages/my-plugin

# Update package.json: name, description, keywords
# Update src/index.tsx: plugin ID, slot handler
# Add to root README table
# Add to pnpm-workspace.yaml catalog if new dependencies needed

    See CONTRIBUTING.md for full contribution workflow.

    Publishing

    The project uses Changesets for versioning and publishing. All releases are automated via GitHub Actions:

    pnpm changeset        # record version changes (patch/minor/major)
# Merge PR → CI publishes automatically

    Do not npm publish manually. Always go through the changesets → PR → main → release pipeline.

    Command Purpose
    pnpm changeset Create a new changeset
    pnpm ci:publish Build + publish (CI only)

    Repository

    License

    MIT — see LICENSE.