The Table of Contents

Begin at the beginning. The Guides seat you at the table - install, first commands, and how to introduce your agent politely. Safety is the house rules: what cannot happen at this table, and why each refusal names a safer way. The Reference sets out every command and flag - those pages are poured straight from the CLI itself, so they are never out of date. The Design decisions are the arguments we had so you don’t have to, and the Appendices hold the longer answers: why madtea exists, how it compares, and what it is compatible with.

Everything here is brewed from the madtea repository - the site is only the china it is served in.

  • Take a Seat Install madtea on Linux, macOS, or Windows, and wire in your agent.
  • Guides Setup and usage guides - install madtea, connect a forge, wire in your agent.
  • Safety The agent-safety model - credential handling, safe body edits, guard hooks, wrong-repo protection.
  • Reference Every command and flag, CLI and MCP alike, generated from the tool itself.
  • Design decisions The decision records behind how madtea behaves.
  • Appendices Why madtea exists, how it compares, permissions, and compatibility.