Vibepulse

VibePulse

VibePulse is a macOS menu bar app that tracks token spend for locally used AI coding agents parsed by [agentsview](https://github.com/kenn-io/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 Postg