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

# Agent rules (AGENTS.md)

> Piebald supports agent rules: AGENTS.md et al.

<Badge color="blue">Available in Piebald Basic (Free)</Badge>

Piebald supports `AGENTS.md` ([https://agents.md/](https://agents.md/)).  It will automatically read it from the current directory and attach it to the current chat:

<img className="shadow-md rounded-xl" width="400" alt="Screenshot of a message with AGENTS.md attached" src="https://mintcdn.com/piebald/-AaSH-LxuVoxYcZl/imgs/v0-1-10/agents_md.png?fit=max&auto=format&n=-AaSH-LxuVoxYcZl&q=85&s=fa1e54059142d0ce7610669ddd105af8" data-path="imgs/v0-1-10/agents_md.png" />

## Alternative file names

While `AGENTS.md` is preferred, Piebald will also read from the following other common file names:

* `CLAUDE.md`
* `GEMINI.md`
* `CRUSH.md`
* `QWEN.md`
* `IFLOW.md`
* `WARP.md`
* `copilot-instructions.md`
* `.junie/guidelines.md`
* `.kiro/guidelines.md`
* [+ Add](https://github.com/Piebald-AI/piebald-issues/issues/new?title=Add+new+AGENT.md+alternative+file+name%3a%20)

If you'd like Piebald to support another file name, please [open an issue](https://github.com/Piebald-AI/piebald-issues/issues/new?title=Add+new+AGENT.md+alternative+file+name%3a%20)!