Bouncer

Leia em Portugues

---

Status: Proof of Concept / Pre-Alpha. Infrastructure only. Core functionality is not yet implemented.

Local-first code search and navigation tool for MCP agents. Designed to reduce LLM token usage by pointing agents to the right reference before they scan entire files.

Requirements

• Python 3.12+
• Git
• PostgreSQL with pgvector enabled
• A local Git workspace with Python code

Setup

python3 -m pip install -e .[dev]

Configuration

Bouncer uses a TOML configuration file at ~/.config/bouncer/config.toml to map workspace aliases to root paths. This path can be overridden via environment variable.

Run

bouncer

Development

make lint      # run ruff linter
make format    # auto-format with ruff
make test      # run tests

---

Acknowledgments

This project benefited from the collaboration of Gemini, Claude, and GPT in assisting with algorithm structuring and code review.