# 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](https://aymericbeaumet.gitbook.io/pimp/user-guide/template-engine).

### 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`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aymericbeaumet.gitbook.io/pimp/user-guide/pimpfile.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.