Viber

A macOS desktop application for analyzing and monitoring Claude conversation data with real-time token usage tracking.

brew install --cask jspiner/viber/viber

Viber Install Guide

Features

• Real-time Monitoring: Track your Claude token usage in real-time with automatic updates every 30 seconds
• Usage Analytics: View detailed statistics of your token consumption over time
• Multi-tier Support: Supports Pro ($20/month), Max 5x ($100/month), and Max 20x ($200/month) subscription tiers
• Session Logs: Browse through your conversation history with detailed metrics
• Dark Mode: Beautiful dark-themed UI designed specifically for macOS
• Token Limits: Monitor 5-hour and weekly token windows with visual progress indicators
• Cost Tracking: Track estimated costs based on your usage patterns with accurate Claude pricing
• Cache Savings: See how much you save with Claude's caching feature
• Status Bar Integration: Optional macOS status bar icon showing current usage
• Real-time Alerts: Get notified when approaching token limits
• Session Analysis: View per-session token usage, costs, and cache efficiency
• Hooks Support: Extensible hook system for custom integrations and workflows

Screenshots

Now Tab - Real-time Monitoring

Track your Claude token usage in real-time with visual progress indicators and automatic updates.

Statistics Tab - Usage Analytics

View detailed charts and analytics of your token consumption patterns over time.

Session Log Tab - Conversation History

Browse through your past conversations with detailed metrics and search functionality.

Agents Tab - Claude Agents

Manage agents

Hooks - Claude Notification

Manage claude job done notification. Set up custom hooks to integrate Viber with your workflows and automation tools.

Settings Tab - Configuration

Configure your subscription tier, alerts, and application preferences.

Status Bar Integration

Optional macOS status bar icon showing your current usage at a glance.

Requirements

• macOS 10.13 or later
• Node.js 18.0 or later
• npm or yarn
• Access to ~/.claude/projects/ directory

Installation

Option 1: Homebrew (Recommended)

1. Download the App
   • just run brew install --cask jspiner/viber/viber

Option 2: Build from Source (For Developers)

1. Clone the repository:

git clone https://github.com/JSpiner/viber.git
cd viber

2. Install dependencies:

npm install

3. Run in development mode:

npm start

Building

For Development

npm start

For Production

Build for macOS (creates both .dmg and .zip):

npm run dist

Build only DMG:

npm run dist:dmg

Build only ZIP:

npm run dist:zip

The built applications will be in the dist/ directory.

Development

Key Technologies

• Electron: Cross-platform desktop application framework
• Chart.js: Data visualization for usage charts
• electron-store: Persistent settings storage
• Jest: Testing framework for unit and integration tests
• Canvas API: Dynamic status bar icon generation

Running Tests

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

Pricing Configuration

The app uses the following Claude pricing (per 1K tokens):

Model	Input	Output	Cache Write	Cache Read
Claude Opus 4	$0.015	$0.075	$0.01875	$0.0015
Claude Sonnet 4	$0.003	$0.015	$0.00375	$0.0003
Claude Haiku 3	$0.00025	$0.00125	$0.0003	$0.00003

Configuration

Viber stores its configuration in:

• macOS: ~/Library/Application Support/viber/

Settings include:

• Selected subscription tier
• Status bar preferences (visibility, icon style)
• Alert thresholds (percentage-based warnings)
• Update frequency
• Notification preferences
• Hook configurations

Hooks System

Viber supports a powerful hooks system for custom integrations:

• usage-update: Triggered when token usage updates
• limit-warning: Triggered when approaching token limits
• session-complete: Triggered when a Claude session ends
• daily-reset: Triggered at daily reset times

Hooks can execute shell commands with access to usage data via environment variables.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Guidelines

• Follow the existing code style
• Add tests for new features
• Update documentation as needed
• Ensure all tests pass before submitting PR
• Test on both Intel and Apple Silicon Macs if possible

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built with Electron
• Charts powered by Chart.js
• Inspired by the need for better Claude usage analytics

Support

If you encounter any issues or have questions:

• Open an issue on GitHub Issues
• Check existing issues before creating a new one
• Include your macOS version and architecture (Intel/Apple Silicon) in bug reports

---

Made with ❤️ for the Claude community