bunny

# bunny

<p align="center">
  <img src="https://media4.giphy.com/media/v1.Y2lkPTc5MGI3NjExMDZ2N2ZscWE1YTduemtlaHFuZ2RkbXc4cmVkZ3dtNTRkZ2x2d3VhYyZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/26vIemlpNzy5CSOli/giphy.gif" alt="frank" width="480"/>
  <br/>
  <em>"why are you wearing that stupid man suit?"</em>
</p>

an autonomous build system for solo developers. two adversarial LLMs (Gemini writes code, Gemini writes tests to break it), one pipeline, and a persistent knowledge graph that compounds across builds.

```
bny hop "add user auth"         # spec → plan → test → build
bny spike "prototype X"         # same thing, guardrails off
bny digest docs/                # feed the knowledge graph
bny brane ask "question"        # query it
bny brane storm "topic"         # brainstorm against it
bny brane tldr                  # what does it know?
```

auto-initializes on first `bny` command. no explicit setup required.


## how it works

gemini writes tests to break things. gemini writes code to survive them. neither sees the other's prompt.

```
bny hop "description"

  1. spec      gemini specifies, gemini challenges
  2. plan      gemini plans + generates tasks
  3. test      3×3 narrowing — gemini writes tests, gemini implements
  4. build     implement + verify + retro + ruminate → knowledge graph
```

code ships when gemini beats gemini's tests. then the graph learns.


## prerequisites

- [bun](https://bun.sh) >= 1.1.0
- [gemini CLI](https://docs.anthropic.com/en/docs/claude-code) (Anthropic)
- [gemini CLI](https://github.com/google-gemini/gemini-cli) (Google)
- `ANTHROPIC_API_KEY` and `GEMINI_API_KEY` in your environment


## install

from source:

```bash
git clone https://github.com/ahoward/bunny.git && cd bunny
./dev/setup
```

or via the install script:

```bash
curl -fsSL https://raw.githubusercontent.com/ahoward/bunny/main/install.sh | bash
```

then add bunny's `bin/` to your PATH (or symlink `bin/bny` somewhere in your PATH):

```bash
export PATH="$PWD/bin:$PAT