Skip to content

Releases: holistic-ai/surface

Release list

v0.1.0

v0.1.0 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 Jul 22:58
v0.1.0
b5959a3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First release.

Added

  • Tool detection. Recognises 18 AI tools from PATH, config directories,
    editor extensions, running processes and installed applications, and marks
    which of them can execute code on this machine.
  • Site detection. Visit counts for 30 known AI domains across 10 browsers in
    the Chromium and Firefox families. The domain filter runs inside SQLite, so no
    other browsing history is ever loaded.
  • Token usage. Reads the transcripts Claude Code, Codex and OpenCode already
    write, attributing tokens per day, tool, model and git repository.
  • Cost. Prices usage against LiteLLM's public table, with an optional
    comparison against what you actually pay via [cost.subscriptions].
  • Dashboard. A terminal UI with Overview, Tools, Sites, Usage, Cost and Repos
    views; mouse and keyboard navigation; and charts groupable by day, week or
    month.
  • --json for the full scan as a versioned payload, --offline to skip
    the one network request, --check to print resolved paths and settings,
    and --demo to explore the dashboard on mock data.
  • Incremental scans. The first run reads every transcript; later runs read
    only appended bytes.
  • One-line installers for macOS, Linux and Windows, which verify the download
    against the release's SHA256SUMS before installing. Prebuilt archives are
    published for six targets, and every archive carries a Sigstore build
    provenance attestation verifiable with gh attestation verify.

Known limits

  • Unpriced is not free. A model missing from the price table shows as
    ▲ unpriced rather than $0.00, and any total above an unpriced model is
    marked ≥ because it is a floor, not an estimate.
  • Cache-creation tokens are priced at input rates where a provider does not
    publish a separate cache-write rate, so those totals are also floors.
  • Prices are API list rates. surface reads no account state and does not
    guess your plan.
  • Browser history needs the sqlite feature, which is on by default but
    requires a C toolchain when building from source. A
    --no-default-features build drops the Sites view and OpenCode token counts —
    and reports them as unreadable rather than as zero.
  • Safari history needs Full Disk Access and is reported as an unreadable
    browser rather than counted as no usage.
  • Windows on arm64 gets the x86-64 binary, which runs emulated. There is no
    native arm64 Windows build yet.
  • Coverage tables go stale. A tool, domain or browser missing from them is
    simply not reported; nothing is misattributed.
Assets 9
Loading