{"id":"c0fef9c8-213b-49dd-9723-3208e46ef3d2","slug":"aibadger","kind":"skill","name":"aibadger","summary":"AI Badger - Local-first tool that extracts focused repo context for any AI chat (Claude, ChatGPT, Grok, etc.) without wasting tokens on irrelevant files.","owner":"PVRLabs","repoUrl":"https://github.com/PVRLabs/aibadger","license":"MIT","licenseTier":"permissive","trust":"community","stars":52,"match":null,"fewStars":false,"format":"skill","createdAt":"2026-05-08T20:58:25.000Z","addedAt":"2026-10-14T06:05:27.702Z","logoUrl":"https://avatars.githubusercontent.com/u/270055163?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["memory-knowledge","developer-tools","files-documents"],"tags":["ai","chatgpt","cli","code-review","context","developer-tools","golang","llm"],"runtime":"go","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T06:38:34.971Z","sample":false,"url":"https://conduits.dev/tools/aibadger","language":"Go","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"![AI Badger](assets/hero.png)\n\n# AI Badger — Local AI Coding Context Tool\n\n**Get a second opinion on your code changes using the AI chat you already use.**\n\nBadger is a local-first repository-context bridge for reviews, design questions, and coding-agent workflows. It prepares focused context locally; you control what you share with your AI chat.\n\n[![Release](https://img.shields.io/github/v/release/PVRLabs/aibadger)](https://github.com/PVRLabs/aibadger/releases/latest)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Homebrew](https://img.shields.io/badge/Homebrew-available-brightgreen)](https://github.com/PVRLabs/homebrew-tap)\n[![skills.sh](https://skills.sh/b/PVRLabs/aibadger)](https://skills.sh/PVRLabs/aibadger)\n\n**Local processing • No automatic uploads • No API keys • No telemetry**\n\n[▶ Try Interactive Demo](https://pvrlabs.xyz/aibadger/demo.html) • [Install](#install)\n\n[![AI Badger Interactive Demo](assets/demo.gif)](https://pvrlabs.xyz/aibadger/demo.html)\n\n## How it works\n\n**1. Map**  \nEnter your goal. Badger builds a prompt.  \n↳ You copy it → paste into your AI chat\n\n**2. Extract**  \nAI replies asking for specific files.  \n↳ You copy that → paste back into Badger\n\n**3. Review and Apply**\n\nBadger fetches those files and builds a second prompt.\n\n↳ You copy it → paste into AI → review its response in Badger → confirm any writes\n\n✓ Context is prepared locally — your AI provider receives what you paste\n\n✓ You control every paste and every write\n\n## Why AI Badger?\n\n- **Universal compatibility** — Works with any AI chat interface or local model\n- **User-controlled sharing** — Nothing is uploaded automatically\n- **Token & cost efficient** — Send only relevant context instead of repeatedly feeding the whole repository to cloud models\n- **Precise & lightweight** — Built in Go, fast, minimal overhead\n- **Specialized modes** — `review` and `design` for common workflows\n\n## Install\n\n### Homebrew (Recommended)\n```bash\nbrew install pvrlabs/tap/badger\n```\n\n### Quick Curl Install\n```bash\ncurl -fsSL https://raw.githubusercontent.com/PVRLabs/aibadger/main/install.sh | sh\n```\n\nSee [docs/install.md](docs/install.md) for Windows, source builds, and more.\n\nAlso available as an official [VS Code companion](https://marketplace.visualstudio.com/items?itemName=pvrlabs.ai-badger) ([GitHub](https://github.com/PVRLabs/aibadger-vscode)).\n\n## Agent Skills\n\nBadger includes the `handoff` and `badger-review` skills for continuing an AI\ncoding session or requesting an independent review. See the [Agent Skills\nguide](skills/README.md) for installation, usage, and details.\n\n## Quick Start\n\nFor an independent review of your Git changes:\n\n- **VS Code:** With the optional [companion extension](https://marketplace.visualstudio.com/items?itemName=pvrlabs.ai-badger), open Source Control and choose **AI Badger: Copy All Changes for Review**, then paste the request into your AI chat. This direct review does not require the CLI.\n- **CLI:** Run `badger review` in your project root, copy the prepared review request, and paste it into your AI chat.\n\nFor deeper repository or design questions, use Map → Extract:\n\n1. Run `badger` in your project root. Interactive sessions start in Design focus.\n2. Type your goal (or leave the editor empty and press Enter to explore the project).\n3. Copy **Prompt 1** → paste into your AI chat.\n4. When the AI asks for files, copy its response → paste back into Badger.\n5. Copy **Prompt 2** → paste back to the AI.\n6. Paste the AI’s response into Badger → review and apply changes.\n\n### Specialized Modes\n- `badger code` — explicitly start in Code focus\n- `badger design` — explicitly start in Design focus with an empty editor\n\nFull usage: [docs/usage.md](docs/usage.md)\n\n## Offline Codebase Map\n\nRun `badger map` to generate a local, offline HTML map of your codebase.\nExplore folders and see where source lines are concentrated.\n\n[Live demo](https://pvrlabs.xyz/aibadger/codemap/) · [Guide](docs/codemap.md)\n\n## Learn More\n\n- [Usage Examples & Walkthrough](docs/usage.md)\n- [Browser Handoff Guide](docs/handoff.md)\n- [Configuration: User limits and external context](docs/settings.md)\n- [API Reference](docs/api.md) — Non-interactive commands for editors and scripts\n- [Agent Integrations](docs/agents.md) — Compact repository orientation for coding agents\n- [Limitations & Supported Projects](docs/limitations.md)\n- [Privacy & Safety](docs/privacy.md)\n- [Contributing](docs/development.md)\n\n---\n\n**If AI Badger makes your coding workflow simpler, consider starring the repo ⭐**\n"}