Installation

Homebrew (macOS, Linux)

brew install agent-receipts/tap/dashboard

Prebuilt binaries

Binaries for darwin/linux (amd64, arm64) are attached to each GitHub release.

Install with Go

go install github.com/agent-receipts/dashboard/cmd/dashboard@latest

Build from source

git clone https://github.com/agent-receipts/dashboard.git
cd dashboard
make build

Usage

If you use the standard per-user path (~/.local/share/agent-receipts/receipts.db), no flags are needed:

dashboard

Then open http://localhost:8080 in your browser.

Options

Flag	Default	Description
-db	~/.local/share/agent-receipts/receipts.db	Path to a receipt SQLite database
-port	8080	Port to serve on

Example

# Standard local install — no flags required
dashboard

# Point at a custom database
dashboard -db ./receipts.db

# Use a custom port
dashboard -port 9090