GitHub - nathabonfim59/cerebras-code-monitor: A tool keep tabs on your Cerebras Code usage limits, in real time

3 min read Original article ↗

Cerebras Code Monitor

GitHub release (latest by date)

Never run out of tokens again! Monitor your Cerebras AI usage in real-time with rate limit tracking, usage predictions, and warnings before you hit your limits.

image

Quick Start

1. Install (choose one):

# Linux/macOS
curl -fsSL https://raw.githubusercontent.com/nathabonfim59/cerebras-code-monitor/main/install.sh | bash

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/nathabonfim59/cerebras-code-monitor/main/install.ps1 | iex

2. Get your session token:

  • Go to cloud.cerebras.ai and sign in
  • Press F12 → Application → Cookies → copy the authjs.session-token value
  • Set it: export CEREBRAS_SESSION_TOKEN="your-token-here"
  • Or save it permanently in ~/.config/cerebras-monitor/settings.yaml (Windows: %APPDATA%\cerebras-monitor\settings.yaml)

3. Start monitoring:

That's it!

What You Get

  • Real-time dashboard - See your usage update live
  • Rate limit tracking - Never hit unexpected limits
  • Multi-organization support - Switch between orgs easily
  • Usage predictions - Know when you'll hit your limits
  • Token consumption monitoring - Track every request
  • Clean terminal interface - Beautiful, responsive display
image

Coming Soon

  • Automatic request interception
  • Smart alerts and warnings
  • Historical usage trends
  • Export capabilities

Basic Usage

# Start with default settings
cerebras-monitor

# Custom refresh rate
cerebras-monitor --refresh-rate 5

# Choose organization
cerebras-monitor --org-id your-org-id
More Installation Options

Manual Download

Download from the releases page.

Using Go Install

go install github.com/nathabonfim59/cerebras-code-monitor/cmd@latest

Building from Source

git clone https://github.com/nathabonfim59/cerebras-code-monitor.git
cd cerebras-code-monitor
go build -o cerebras-monitor cmd/main.go
Authentication Details

Session Cookie Authentication (Recommended)

Provides the most accurate data and full organization access.

  1. Log into Cerebras Cloud
  2. Extract session token from browser cookies:
  3. Set as environment variable or save in config file

Note: The session token is HTTP-only and must be manually copied. This tool only uses it to fetch your usage data - source code is available for inspection.

API Key Authentication (Alternative)

Limited functionality compared to session token:

  • Shows only data for that specific key
  • Cannot switch organizations
  • Less accurate predictions
  • Each request consumes ~5 tokens for metadata

To use:

export CEREBRAS_API_KEY="your-api-key"
# or
cerebras-monitor login apikey your-api-key
Configuration Options
Parameter Type Default Description
--session-token string "" Cerebras session token
--org-id string "" Organization ID to monitor
--model string "qwen-3-coder-480b" Model to monitor
--refresh-rate int 10 Data refresh rate in seconds (1-60)
--refresh-per-second float 0.75 Display refresh rate in Hz (0.1-20.0)
--timezone string auto Timezone (auto-detected)
--time-format string auto Time format: 12h, 24h, or auto
--theme string auto Display theme: light, dark, or auto
--log-level string INFO Logging level
--icons string emoji Icon set: emoji or nerdfont
Understanding Cerebras Rate Limits

Cerebras enforces rate limits per API key with these response headers:

Header Description
x-ratelimit-limit-requests-day Maximum requests per day
x-ratelimit-limit-tokens-minute Maximum tokens per minute
x-ratelimit-remaining-requests-day Requests remaining today
x-ratelimit-remaining-tokens-minute Tokens remaining this minute
x-ratelimit-reset-requests-day Daily limit reset time (seconds)
x-ratelimit-reset-tokens-minute Minute limit reset time (seconds)
Development & Contributing

Built With

  • Go with spf13/cobra for CLI
  • spf13/viper for configuration
  • sqlc for database queries

Prerequisites

  • Go 1.24.5 or higher
  • sqlc (for database code generation)

Building

# Install sqlc
go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest

# Generate database code
sqlc generate

# Build
go build -o cerebras-monitor main.go

Testing

Release Process

# Create and push tag
git tag -a v0.1.0 -m "v0.1.0"
git push origin v0.1.0

# Test locally
make release-dry

# Create snapshot
make snapshot

API Integration

Makes requests to: https://cloud.cerebras.ai/api/graphql

Rate limit data extracted from response headers.

License

MIT License

Contributing

Contributions welcome! Fork the repository and submit a pull request.