VibePulse

VibePulse is a macOS menu bar app that tracks token spend for locally used AI coding agents parsed by agentsview.

Highlights

• Agents parsed by the installed agentsview version should work automatically once they have positive-cost local usage in the past 30 days
• Combined daily total in the menu bar (what you would pay per token without a subscription)
• Today view shows cumulative spend over the day
• 30-day view shows daily totals with per-tool breakdown
• Configurable refresh schedule
• Built-in data maintenance for historical imports

Screenshots

Requirements

• macOS 13+ (Ventura)
• agentsview current release installed with usage daily --timezone support (agentsview on PATH or path set in Settings)
• Local usage from at least one agentsview-parsed agent with priced activity in the past 30 days

Install

1. Download the latest .dmg from GitHub Releases.
2. Drag VibePulse.app to your Applications folder.
3. Launch it. If macOS blocks the app, open System Settings -> Privacy & Security and allow it.

First run

• A welcome window explains the agentsview requirement, notes the default 15-minute refresh cadence, and lets you toggle start at login.
• You can revisit Settings from the menu bar at any time.

agentsview setup

Install agentsview:

curl -fsSL https://agentsview.io/install.sh | bash

This installs agentsview to ~/.local/bin/agentsview or /usr/local/bin/agentsview.

VibePulse runs outside your shell, so if agentsview is installed to a non-standard location, set the path in Settings -> Dependencies. To read from a PostgreSQL-backed agentsview pg serve instance instead, set its URL there; for example, http://127.0.0.1:18080.

Settings

• Data Sources: VibePulse discovers agents with positive-cost usage in the past 30 days. Turning one off hides it from totals and charts without stopping imports or deleting history.
• Startup: Start VibePulse at login (macOS may require approval).
• Dependencies: Set an agentsview pg serve URL, or a custom local agentsview path.
• Refresh: Choose how often the app refreshes (5m, 15m, 1h, 4h, 1d).
• Data Maintenance: Normalize historical data and rerun import fixes.

Security & privacy

• All usage data stays local on your machine.
• The database lives at ~/Library/Application Support/VibePulse/vibepulse.sqlite.
• VibePulse has no analytics or telemetry.
• It runs one aggregate 30-day agentsview usage report to discover agents, then filtered per-agent reports to store their usage. Reports come from the configured server when present, otherwise from the local CLI.

Troubleshooting

• Agent not shown: Run agentsview usage daily --format json --breakdown --since 30d --timezone America/Los_Angeles in Terminal, replacing the timezone with your system's IANA identifier. The agent must appear in agentBreakdowns with positive total cost during that window.
• No data: Run agentsview usage daily in Terminal to verify usage data exists.
• agentsview not found: Install agentsview or set the path in Settings -> Dependencies.
• Start at login: macOS may require approval in System Settings -> Login Items.

Local development

swift run

Build a DMG

scripts/build_dmg.sh v0.1.0

The DMG will be created in dist/.

License

MIT