About this project
anacraft is a Rust command-line tool that reads Google Analytics 4 data back as a terminal dashboard. Its README frames the project as "Google Analytics, mined block by block": seven toggleable panels render GA4 metrics with ore-textured bars, a realtime event feed, and achievement toasts. Running the bare `craft` command opens the dashboard, and with no property saved it runs on synthetic data, so it can be tried before signing in.
Setup paths include an install script for macOS/Linux, `cargo install --git`, or a manual binary from Releases. Connecting an existing property uses OAuth (`craft login`), then `craft props` to list readable properties and `craft use <id>` to save a default. A separate `craft configure <domain>` command creates a GA4 property and web data stream and prints the gtag.js snippet; the README states this is the only command that changes anything in the Analytics account and that it is part of a paid plan.
Beyond the dashboard, the tool offers one-shot reports (`overview`, `pages`, `portals`, `realms`, `live`, `demo`) with `--format json` and `--format slack` output for piping into scripts or webhooks. `craft audit` runs fifteen checks over a configurable window, reading both the Data API and Admin API to distinguish measurement problems from configuration problems; `--fix` can mark already-recorded outcomes as key events and enable measurement the existing tag supports. `craft watch` compares the latest complete day against a baseline and reports drops, spikes, and silence, with per-metric thresholds configurable in TOML and optional Slack delivery via an installed webhook.
The dashboard has seven panels (events, realtime, countries map, top pages, vitals, top countries, daily users) with keyboard toggles, multiple palettes, and multi-property switching. An MCP server (`craft mcp`) exposes tools such as `site_status`, `audit_site`, `live_visitors`, and list/search tools so MCP clients like Claude Desktop can query the same numbers; `configure_site` is described as the single writer. Configuration lives in `~/.config/anacraft/config.toml`, with OAuth tokens kept separately in `~/.anacraft/`. Several features are gated behind subscription plans, while `--demo` modes are ungated.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.