Guides

• Configuration & first run How to point madtea at your forge, where it stores credentials, and how the override precedence resolves.
• Editor & MCP client setup The same madtea binary serves an MCP endpoint over stdio (madtea serve).
• Raw API passthrough madtea api makes a raw call against the forge’s REST API and prints the response.
• secret-exec — run a command with your token, never on disk madtea secret-exec runs a child command with your stored Forgejo/Gitea token injected into its environment.
• Take a Seat Install madtea on Linux, macOS, or Windows - one self-contained binary, one prerequisite: git.
• Troubleshooting Guide This guide covers common errors in madtea, their causes, and how to fix them. Error messages are taken directly from the codebase.