Skip to content
Back to search

aibadger

AI Badger - Local-first tool that extracts focused repo context for any AI chat (Claude, ChatGPT, Grok, etc.) without wasting tokens on irrelevant files.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/PVRLabs/aibadger with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/PVRLabs/aibadger'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pvrlabs--aibadger/badge.svg)](/listings/pvrlabs--aibadger)

HTML

<a href="/listings/pvrlabs--aibadger"><img src="/api/listings/pvrlabs--aibadger/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Homebrew (Recommended)

brew install pvrlabs/tap/badger

Quick Curl Install

curl -fsSL https://raw.githubusercontent.com/PVRLabs/aibadger/main/install.sh | sh

See [docs/install.md](docs/install.md) for Windows, source builds, and more.

Also available as an official [VS Code companion](https://marketplace.visualstudio.com/items?itemName=pvrlabs.ai-badger) ([GitHub](https://github.com/PVRLabs/aibadger-vscode)).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 124 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ![AI Badger](assets/hero.png)
  2. # AI Badger — Local AI Coding Context Tool
  3. **Get a second opinion on your code changes using the AI chat you already use.**
  4. Badger 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.
  5. [![Release](https://img.shields.io/github/v/release/PVRLabs/aibadger)](https://github.com/PVRLabs/aibadger/releases/latest)
  6. [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  7. [![Homebrew](https://img.shields.io/badge/Homebrew-available-brightgreen)](https://github.com/PVRLabs/homebrew-tap)
  8. [![VS Code Marketplace](https://img.shields.io/badge/VS_Code-Marketplace-007ACC)](https://marketplace.visualstudio.com/items?itemName=pvrlabs.ai-badger)
  9. [![skills.sh](https://skills.sh/b/PVRLabs/aibadger)](https://skills.sh/PVRLabs/aibadger)
  10. **Local processing • No automatic uploads • No API keys • No telemetry**
  11. [▶ Try Interactive Demo](https://pvrlabs.xyz/aibadger/demo.html) • [Install](#install)
  12. [![AI Badger Interactive Demo](assets/demo.gif)](https://pvrlabs.xyz/aibadger/demo.html)
  13. ## How it works
  14. **1. Map**
  15. Enter your goal. Badger builds a prompt.
  16. ↳ You copy it → paste into your AI chat
  17. **2. Extract**
  18. AI replies asking for specific files.
  19. ↳ You copy that → paste back into Badger
  20. **3. Review and Apply**
  21. Badger fetches those files and builds a second prompt.
  22. ↳ You copy it → paste into AI → review its response in Badger → confirm any writes
  23. ✓ Context is prepared locally — your AI provider receives what you paste
  24. ✓ You control every paste and every write
  25. ## Why AI Badger?
  26. - **Universal compatibility** — Works with any AI chat interface or local model
  27. - **User-controlled sharing** — Nothing is uploaded automatically
  28. - **Token & cost efficient** — Send only relevant context instead of repeatedly feeding the whole repository to cloud models
  29. - **Precise & lightweight** — Built in Go, fast, minimal overhead
  30. - **Specialized modes** — `review` and `design` for common workflows
  31. - **[Visual codebase map](#offline-codebase-map)** — Explore your repository with an interactive, offline HTML map
  32. ## Install
  33. ### Homebrew (Recommended)
  34. ```bash
  35. brew install pvrlabs/tap/badger
  36. ```
  37. ### Quick Curl Install
  38. ```bash
  39. curl -fsSL https://raw.githubusercontent.com/PVRLabs/aibadger/main/install.sh | sh
  40. ```
  41. See [docs/install.md](docs/install.md) for Windows, source builds, and more.
  42. Also available as an official [VS Code companion](https://marketplace.visualstudio.com/items?itemName=pvrlabs.ai-badger) ([GitHub](https://github.com/PVRLabs/aibadger-vscode)).
  43. ## Quick Start
  44. For an independent review of your Git changes:
  45. - **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.
  46. - **CLI:** Run `badger review` in your project root, copy the prepared review request, and paste it into your AI chat.
  47. For deeper repository or design questions, use Map → Extract:
  48. 1. Run `badger` in your project root. Interactive sessions start in Design focus.
  49. 2. Type your goal (or leave the editor empty and press Enter to explore the project).
  50. 3. Copy **Prompt 1** → paste into your AI chat.
  51. 4. When the AI asks for files, copy its response → paste back into Badger.
  52. 5. Copy **Prompt 2** → paste back to the AI.
  53. 6. Paste the AI’s response into Badger → review and apply changes.
  54. ### Specialized Modes
  55. - `badger code` — explicitly start in Code focus
  56. - `badger design` — explicitly start in Design focus with an empty editor
  57. Full usage: [docs/usage.md](docs/usage.md)
  58. ## Offline Codebase Map
  59. <table>
  60. <tr>
  61. <td width="240">
  62. <a href="https://pvrlabs.xyz/aibadger/codemap/">
  63. <img src="docs/images/codemap-thumbnail.webp" alt="Treemap of AI Badger repository folders" width="240">
  64. </a>
  65. </td>
  66. <td>
  67. <p>Explore your codebase visually. Run <code>badger map</code> to generate an interactive, offline HTML map of your repository and see where source lines are concentrated.</p>
  68. <p><a href="https://pvrlabs.xyz/aibadger/codemap/">Try the live demo →</a> · <a href="docs/codemap.md">Map your own repository</a></p>
  69. </td>
  70. </tr>
  71. </table>
  72. ## Agent Skills
  73. Badger includes the `handoff` and `badger-review` skills for continuing an AI
  74. coding session or requesting an independent review. See the [Agent Skills
  75. guide](skills/README.md) for installation, usage, and details.
  76. ## Learn More
  77. - [Usage Examples & Walkthrough](docs/usage.md)
  78. - [Browser Handoff Guide](docs/handoff.md)
  79. - [Configuration: User limits and external context](docs/settings.md)
  80. - [API Reference](docs/api.md) — Non-interactive commands for editors and scripts
  81. - [Agent Integrations](docs/agents.md) — Compact repository orientation for coding agents
  82. - [Limitations & Supported Projects](docs/limitations.md)
  83. - [Privacy & Safety](docs/privacy.md)
  84. - [Verify Local-Only Operation](docs/network-verification.md)
  85. - [Contributing](docs/development.md)
  86. ---
  87. **If AI Badger makes your coding workflow simpler, consider starring the repo ⭐**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.