> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiny-brain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> TDD guardrails, task pipelines, and adversarial review for AI coding agents

tiny-brain wraps your AI coding loop with guardrails: every piece of work is a
tracked task, every task moves through a RED → GREEN → REFACTOR pipeline
enforced by git hooks, and every implementation commit is adversarially
reviewed before the cycle closes. A local dashboard streams the whole thing
live from your machine.

## What it does

<CardGroup cols={2}>
  <Card title="Plans as markdown" icon="file-lines">
    PRDs, features, fixes, and tasks live as markdown in your repo. The
    markdown is the source of truth; progress state is projected from it
    automatically.
  </Card>

  <Card title="TDD enforced by hooks" icon="shield-check">
    Commit-msg and post-commit hooks derive the phase of every task from its
    commit history — failing tests first, minimal implementation second,
    review-driven refactor third.
  </Card>

  <Card title="Adversarial review" icon="user-secret">
    After every implementation commit, an isolated review agent challenges the
    work and returns a clean or needs-refactoring verdict.
  </Card>

  <Card title="Local dashboard" icon="chart-line">
    Watch plans, phases, reviews, and quality runs stream to a dashboard on
    your own machine — only your AI tool's token calls leave it, to a
    provider you've authorised.
  </Card>
</CardGroup>

## Install

Install with Homebrew:

```bash theme={null}
brew install magic-ingredients/tap/tiny-brain
```

Or with the installer script:

```bash theme={null}
curl -fsSL https://get.tiny-brain.com | sh
```

Then bootstrap your repo:

```bash theme={null}
tiny-brain init
```

## Learn more

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    From zero to a live, guarded loop in three commands.
  </Card>

  <Card title="Your first PRD" icon="map" href="/getting-started/first-prd">
    Follow one feature through plan, RED, GREEN, and review.
  </Card>

  <Card title="Dashboard tour" icon="chart-line" href="/getting-started/dashboard">
    What the local dashboard shows while the loop runs.
  </Card>

  <Card title="Releases" icon="github" href="https://github.com/magic-ingredients/tiny-brain-releases">
    Downloads and release notes on GitHub.
  </Card>
</CardGroup>

The [Concepts](/concepts/tdd-loop) section explains the machinery — the
loop, phase derivation, adversarial review, personas, and the tracking
model. The [Markdown Format](/markdown-format/overview),
[CLI Reference](/cli-reference/overview), and
[MCP Tools](/mcp-tools/overview) sections cover the surfaces you'll touch
day to day.