{"slug": "uninstall-beads", "title": "uninstall beads", "summary": "The article describes an uninstall script for the Beads (bd) tool that performs a comprehensive cleanup of all its traces from a system. By default, the script runs in dry-run mode to show what would be deleted without making changes, and the `--apply` flag must be used to actually perform the cleanup. The script removes Beads-related files from per-repository directories, the user's home directory, and system binary locations, with options to skip home or binary cleanup and target specific directories.", "body_md": "# Beads Uninstall Script\n\nA comprehensive uninstall/cleanup script for Beads (`bd`) that removes all traces of the tool from a system.\n\n## Usage\n\n```bash\n./scripts/uninstall.sh            # dry-run (scan $HOME)\n./scripts/uninstall.sh --apply    # perform cleanup\n./scripts/uninstall.sh --root DIR --apply\n./scripts/uninstall.sh --skip-home --skip-binary\n```\n\n## Key Features\n\n- **Dry-run by default** - Shows what would be deleted without making changes. Use `--apply` to actually perform cleanup.\n\n## What It Cleans Up\n\n### Per-Repository Cleanup\n\n- Stops any running bd daemon\n- Removes `.beads/` and `.beads-hooks/` directories\n- Cleans Beads integration from `AGENTS.md` (removes marked sections)\n- Removes bd hooks from `.claude/settings.local.json` and `.gemini/settings.json`\n- Deletes `.cursor/rules/beads.mdc`, `.aider.conf.yml`, `.aider/BEADS.md`\n- Cleans git hooks that contain bd-related code, restoring backups if they exist\n- Removes `merge=beads` from `.gitattributes`\n- Cleans Beads entries from `.git/info/exclude`\n- Unsets `core.hooksPath` if it points to `.beads-hooks`\n- Removes merge driver config (`merge.beads.*`)\n\n### Home Directory Cleanup\n\n- Removes `~/.beads/` and `~/.config/bd/`\n- Cleans hooks from `~/.claude/settings.json` and `~/.gemini/settings.json`\n- Removes Beads entries from global gitignore\n- Removes `~/.beads-planning/` if it has a `.beads` subdirectory\n\n### Binary Cleanup\n\n- Removes `bd` binaries from common locations (`/usr/local/bin`, `/opt/homebrew/bin`, `~/.local/bin`, `~/go/bin`)\n- Runs `brew uninstall bd` if installed via Homebrew\n- Runs `npm uninstall -g @beads/bd` if installed via npm\n\n## Options\n\n| Flag | Description |\n|------|-------------|\n| `--apply` | Actually perform deletions (otherwise dry-run) |\n| `--root DIR` | Scan a specific directory instead of `$HOME` (repeatable) |\n| `--skip-home` | Don't touch home-level files |\n| `--skip-binary` | Don't remove the bd binary |\n| `-h, --help` | Show help |\n\n## Examples\n\n```bash\n# See what would be cleaned (dry-run)\n./scripts/uninstall.sh\n\n# Actually clean everything\n./scripts/uninstall.sh --apply\n\n# Only clean a specific project directory\n./scripts/uninstall.sh --root ~/myproject --skip-home --skip-binary --apply\n\n# Clean multiple directories\n./scripts/uninstall.sh --root ~/project1 --root ~/project2 --apply\n```\n", "url": "https://wpnews.pro/news/uninstall-beads", "canonical_source": "https://gist.github.com/banteg/1a539b88b3c8945cd71e4b958f319d8d", "published_at": "2026-01-03 17:45:57+00:00", "updated_at": "2026-05-22 14:46:29.543011+00:00", "lang": "en", "topics": ["developer-tools"], "entities": ["Beads", "Homebrew", "npm", "Claude", "Gemini", "Cursor", "Aider", "Git"], "alternates": {"html": "https://wpnews.pro/news/uninstall-beads", "markdown": "https://wpnews.pro/news/uninstall-beads.md", "text": "https://wpnews.pro/news/uninstall-beads.txt", "jsonld": "https://wpnews.pro/news/uninstall-beads.jsonld"}}