OpenCode Go Monitor

Real-time OpenCode Go monitoring in your VS Code: status bar. Available in English and Spanish.

Features

• Status bar with real-time quota percentage — See your current OpenCode Go usage at a glance, right in your VSCode status bar
• Color-coded thresholds — Visual feedback with green (normal), yellow (warning), and red (error) colors based on configurable usage thresholds
• Progress bars on hover — Hover over the status bar item to see detailed progress bars for rolling, weekly, and monthly usage
• Selectable display window — Choose which quota window to display: Rolling, Weekly, or Monthly
• Historical tracking and exhaustion prediction — Tracks usage over time and predicts when you might exhaust your quota using linear regression
• HTML scraping backend — Fetches quota data directly from the OpenCode web console using your session cookie (API mode is reserved for a future release)
• Bilingual (EN/ES) — Automatically detects your VSCode language and displays all messages in English or Spanish

Screenshots

Hover over the status bar item to see detailed progress bars for all three quota windows (Rolling, Weekly, Monthly).

What you'll see:

• Status bar: Real-time usage percentage with reset countdown
• Hover tooltip: Visual progress bars for all quota windows
• Color coding: Green (normal), Yellow (≥80%), Red (≥95%)
• QuickPick details: Full breakdown with exhaustion prediction
• Bilingual interface: Automatically adapts to your VSCode language (EN/ES)

Setup

Installation

1. Download the .vsix file from the releases page
2. Open VSCode
3. Go to the Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
4. Click the ... menu (More Actions) and select Install from VSIX...
5. Select the downloaded .vsix file
6. Reload VSCode (Ctrl+Shift+P → Developer: Reload Window)

Obtaining Credentials

You need two pieces of information from your OpenCode account: workspaceId and authCookie.

Getting your authCookie:

1. Log in to opencode.ai in your browser
2. Open DevTools (F12 or Ctrl+Shift+I / Cmd+Option+I)
3. Go to the Application tab (Chrome/Edge) or Storage tab (Firefox)
4. In the left sidebar, expand Cookies and select https://opencode.ai
5. Find the cookie named auth
6. Copy the Value field — this is your authCookie (starts with Fe26.2**...)

Getting your workspaceId:

1. While logged in to opencode.ai, navigate to the Go section
2. Look at the URL in your browser's address bar
3. The URL path will be: /workspace/{workspaceId}/go
4. Copy the {workspaceId} part — this is your workspaceId (e.g., wrk_01KKKYPCYDAY6DQDY1VK1AJ2QT)

Configuring the Extension:

1. Open VSCode Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Type and select: OpenCode Go: Configure Credentials
3. Enter your workspaceId
4. Enter your authCookie (input is masked for security)
5. The extension will immediately start monitoring your quota

Configuration

All settings are available under OpenCode Go Monitor in VS Code: settings:

Note: Credentials (workspaceId and authCookie) are stored securely in VSCode's SecretStorage (OS keychain) and persist across all projects until you explicitly logout.

Commands

All commands are available from the VSCode Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Status Bar

The status bar item shows:

• Text: OC Go Rolling: 13% · 3h 23m (or Weekly/Monthly depending on your selection)
• Hover tooltip: Detailed view with progress bars for all three windows, data source, and last update time
• Colors: Green (normal), Yellow (≥80%), Red (≥95%)

Click the status bar item to open the details QuickPick.

Development

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Run tests
npm test

# Build production bundle
npm run build

# Package as .vsix
npm run package

Project Structure

src/
├── domain/        # Core types, formatting, and prediction algorithms
├── storage/       # Credentials (SecretStorage) and history (globalState)
├── fetchers/      # ApiFetcher, ScrapingFetcher, and FetcherSelector
├── ui/            # StatusBarItem and QuickPick UI components
├── commands/      # All 7 VSCode commands
├── i18n.ts        # Internationalization (English/Spanish)
└── extension.ts   # Extension entry point (activation, polling, lifecycle)

Troubleshooting

"Could not find quota usage data in HTML"

This usually means the cookie is invalid or expired. Try:

1. Log out and log back in to opencode.ai
2. Get a fresh auth cookie from DevTools
3. Re-configure credentials with the new cookie

"Auth expired" in status bar

Your session cookie has expired. Follow the steps above to get a new one.

Debug mode

Enable debug logging by setting opencodeGoQuota.debug to true in settings. View logs in View → Output → OpenCode Go Monitor.

License

MIT