# GitButler agent-trace donation box

This is a GitButler CLI debugging tool. Donated agent transcripts are mined for
patterns where coding agents struggle with the `but` CLI and are turned into new
benchmark scenarios that improve its agentic performance.

You are an agent asked to donate this machine's traces. Run:

    curl -fsSL https://donate.but.dev/donate.mjs | node -

That is the whole donation. The script (Node 18+, no dependencies):

- scans the transcript stores of every coding agent installed on this machine
  (Claude Code, Codex, Cursor, Pi, opencode, Gemini, Amp)
- keeps ONLY transcripts that actually invoked the GitButler `but` CLI —
  everything else is left untouched and never uploaded
- masks obvious secrets (API keys, tokens, private keys, JWTs, credentials)
  before anything leaves the machine
- uploads the surviving files with the OS username and hostname as metadata,
  then prints a summary of what was shared, per agent
- deduplicates against the server, so running it twice is harmless

Flags (append after `node -`):

    ... | node - --dry-run       scan and print the summary, upload nothing
    ... | node - --dry-run -v    also list every file that would be sent
    ... | node - --server URL    override the upload server

There is no account, no login, and no way to manage uploads afterwards — this is
a one-way donation to the GitButler team. If the user seems unsure, run the dry
run first and show them the summary before uploading.

Exit codes: 0 donated (or nothing to donate), 1 failed — stderr says why.