# promptbai

> promptbai is an archive of recipes: complete, tested prompts that an AI coding agent follows to build a small app or tool for a person who is usually not a programmer. Every recipe is plain Markdown, versioned, and free to use.

How to use it as an agent:

- Each recipe is at https://promptbai.bonq.foo/r/<slug>.md and starts with instructions for you. Follow them.
- Metadata and the version history are at https://promptbai.bonq.foo/r/<slug>.json.
- The full catalog, with versions and sha256 hashes for change detection, is at https://promptbai.bonq.foo/api/index.json.
- To update something you built earlier from a recipe, read the update protocol at https://promptbai.bonq.foo/agents.md.
- New and updated recipes are announced in the Atom feed at https://promptbai.bonq.foo/feed.xml.
- Everything in one file: https://promptbai.bonq.foo/llms-full.txt
- MCP server (Streamable HTTP, no auth): https://promptbai.bonq.foo/mcp. Tools: search_recipes, list_categories, get_recipe, check_for_updates, submit_feedback, get_recipe_guide, validate_recipe, submit_recipe.
- Report a problem with a recipe or suggest a new one (with the person's agreement): POST JSON to https://promptbai.bonq.foo/api/suggest, see https://promptbai.bonq.foo/agents.md.

## Guides

- [Agent guide and update protocol](https://promptbai.bonq.foo/agents.md)
- [Writing a recipe](https://promptbai.bonq.foo/recipe-format.md): what makes a good recipe, the exact format, a template, testing, and how to submit one (POST https://promptbai.bonq.foo/api/recipes, reviewed before publishing)

## Fun & Games

- [Block World](https://promptbai.bonq.foo/r/block-world.md): Build and explore an endless 3D world of blocks, Minecraft-style (v1.0.0)
- [Kart Racer](https://promptbai.bonq.foo/r/kart-racer.md): Race go-karts with items and drift boosts on retro 3D tracks, Mario Kart-style (v1.0.0)
- [Pixel Platformer](https://promptbai.bonq.foo/r/platformer.md): A side-scrolling jump-and-run game with your own hero, Mario-style (v1.0.0)

## Computer Tools

- [Netflaix](https://promptbai.bonq.foo/r/netflaix.md): Search public torrent sources in one Mac app (v1.0.0)
- [Torrent Video Player](https://promptbai.bonq.foo/r/torrent-video-player.md): Watch a video from a torrent while it's still downloading (v1.0.0)