> For the complete documentation index, see [llms.txt](https://aymericbeaumet.gitbook.io/pimp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aymericbeaumet.gitbook.io/pimp/user-guide/pimpfile.md).

# Pimpfile

### YAML format

Pimpfile are an important part of pimp. These YAML files allow you to configure command expansion and tasks with a simple and expressive syntax.

The whole file will be rendered with the [Template Engine](/pimp/user-guide/template-engine.md).

### Go format

*todo*

### Resolution order

The following resolution algorithm is being used to prioritize the order in which the Pimpfiles commands will be attempted to be matched:

1. Are we in a git repository?
   1. Yes -> Sequentially open and append the Pimpfiles commands until the root of the repository
   2. No -> Open and append commands from the Pimpfile in the current directory
2. Open and append the commands from the global Pimpfiles as defined in `~/.pimprc`