declaude 0.1.0

Remove Claude/AI attribution from a GitHub repo: clean history, force-push, and refresh the Contributors graph.

declaude

Remove Claude/AI attribution from a GitHub repo — in one command.

declaude OWNER/REPO

It clones the repo, strips Claude/AI traces from your entire commit history (e.g. Co-Authored-By: Claude <[e-mail]> or "Generated with Claude Code"), force-pushes the cleaned branches, and refreshes GitHub's Contributors graph so @claude actually disappears — all without touching your code or your commit authorship.

Why @claude won't go away by itself

AI tools append a Co-Authored-By: Claude … trailer to commits, and GitHub's Insights → Contributors graph counts those co-authors. That graph is a cached, background-computed view — a force-push (or a flush, or a commit) on its own doesn't reliably update it, so @claude lingers even after the history and the REST API are clean.

What actually works is a specific order:

remove Claude → flush (rename the default branch) → push a fresh commit

The flush resets GitHub's cached graph; the following commit triggers a recompute against the now-clean history. declaude does all three for you (the refresh commit is chore: refresh GitHub contributors, reusing your latest commit's author so no new identity appears). It runs even when the history is already clean, which is exactly what a previously-cleaned repo needs.

Install

pip install declaude        # installs the `declaude` command + git-filter-repo

Not yet on PyPI? Install straight from GitHub:

pip install git+https://github.com/ediiloupatty/declaude
# or, from a local clone:
pip install .

pip puts a declaude command on your PATH and pulls in git-filter-repo automatically — no manual setup. The one prerequisite pip can't install is the GitHub CLI, used to flush GitHub's Contributors-graph cache:

# install gh from https://cli.github.com, then log in:
gh auth login

declaude checks for gh and a valid login up front and tells you exactly what's missing before it touches anything.

Usage

declaude ediiloupatty/my-repo                      # OWNER/REPO slug
declaude https://github.com/ediiloupatty/my-repo   # full GitHub URL

declaude my-repo --dry-run    # show the plan, change nothing
declaude my-repo -y           # skip the confirmation prompt
declaude my-repo --no-refresh # clean + push only, skip the refresh commit
declaude my-repo --no-backup  # skip the restorable backup bundle (not recommended)

declaude prevent              # turn off Claude Code attribution going forward
declaude --version            # print the installed version

The repo is cloned to a temp dir, cleaned, force-pushed, refreshed, then discarded — you never clone by hand. Before any rewrite, a backup bundle is written to ~/.declaude-backups/ and is fully restorable:

git -C <repo> fetch ~/.declaude-backups/<name>.bundle '*:*'

Honest caveats

• Claude authorship (rare). If a commit's author is Claude (not just a co-author), declaude warns but does not change it — use git filter-repo --mailmap to rewrite authorship.
• The refresh commit. declaude leaves one chore: refresh GitHub contributors empty commit on the default branch (authored as you). It's harmless; drop it later with git rebase if you like. Skip the whole refresh with --no-refresh.
• Shared repos. The flush renames the default branch and back. Collaborators with a local clone may see GitHub's "default branch renamed" notice. Use --no-refresh if that's a problem.
• Graph lag. Even after the flush + refresh push, the Contributors graph can take a few minutes to update. Recheck in Incognito.
• Closed pull requests. GitHub keeps old commits in refs/pull/N/head, which users can't delete. The Contributors graph is computed from the default branch (clean + refreshed), so @claude should still drop; if it persists, only GitHub Support can purge the PR-ref cache.

Commands

Command	Purpose
declaude TARGET [-y] [--dry-run] [--no-refresh] [--no-backup]	Clean history + force-push + refresh contributors graph. TARGET = GitHub URL or OWNER/REPO.
declaude prevent	Set includeCoAuthoredBy:false in ~/.claude/settings.json.
declaude --version	Print the installed version.

Requirements

• Python 3.8+ and pip
• git
• gh (GitHub CLI, logged in) — install separately from https://cli.github.com
• git-filter-repo — installed automatically as a pip dependency

Windows: works in PowerShell and Windows Terminal (ANSI colors are enabled automatically; set NO_COLOR=1 to disable). git, gh, and Python must be on your PATH.

Development

pip install -e ".[dev]"   # editable install with test deps
python -m pytest          # run the scrubber tests
python -m declaude --help # run without installing the console script

License

MIT © ediiloupatty