# aesop

> A small menagerie of fast tools that keep agentic Python development honest.

Agents write code fast. These keep it from going feral.

Each tool ships a `guide` subcommand that prints agent-oriented usage instructions.
Run `uvx <tool>@latest guide` before using a tool.

## Tools

- [ty-find](https://mojzis.github.io/aesop/ty-find/) (workflow): Find the symbol, not 400 grep hits. Guide: `uvx ty-find@latest guide`. Markdown: https://mojzis.github.io/aesop/ty-find/index.md
- [biston](https://mojzis.github.io/aesop/biston/) (guardrails): Finds the code your agent wrote twice. Guide: `uvx biston@latest guide`. Markdown: https://mojzis.github.io/aesop/biston/index.md
- [zorilla](https://mojzis.github.io/aesop/zorilla/) (guardrails): Sniffs out tests that test nothing. Guide: `uvx zorilla@latest guide`. Markdown: https://mojzis.github.io/aesop/zorilla/index.md
- [pycoati](https://mojzis.github.io/aesop/pycoati/) (guardrails): Tells your agent which tests to fix first. Guide: `uvx pycoati@latest guide`. Markdown: https://mojzis.github.io/aesop/pycoati/index.md
- [gerenuk](https://mojzis.github.io/aesop/gerenuk/) (workflow): Runs only the tests your diff can touch. Guide: `uvx gerenuk@latest guide`. Markdown: https://mojzis.github.io/aesop/gerenuk/index.md
- [madoqua](https://mojzis.github.io/aesop/madoqua/) (workflow): The commit hook that's silent when you're fine and precise when you're not. Guide: `uvx madoqua@latest guide`. Markdown: https://mojzis.github.io/aesop/madoqua/index.md
- [introspect](https://mojzis.github.io/aesop/introspect/) (meta): What did your agent actually do all day? Guide: `uvx introspy@latest guide`. Markdown: https://mojzis.github.io/aesop/introspect/index.md

## Optional

- [Setup prompt: add all tools to a repo](https://mojzis.github.io/aesop/setup/index.md)
- [The guide principle, and a prompt to add `guide` to any CLI](https://mojzis.github.io/aesop/guide/index.md)
- [Everything in one file](https://mojzis.github.io/aesop/llms-full.txt)
- [Author](https://github.com/mojzis): @mojzis