Commands are available in Firebender v0.11.14+
Commands allow you to define custom AI prompts and workflows that can be easily executed through Firebender’s interface. These are markdown files containing instructions that tell the AI what task to perform.

Configuration

Commands are configured in your firebender.json file using the commands array:
{
  "commands": [
    {
      "name": "Generate Firebender Rules",
      "path": "./prompts/generate-rules.md"
    },
    {
      "name": "Write PR Description",
      "path": "~/firebender-commands/pr-description.md"
    }
  ]
}
Each command requires:
  • name: The display name that appears in the UI
  • path: Path to the markdown file containing the command instructions

Command Files

Command files are markdown documents that contain prompts or instructions for the AI. They can include:
  • Natural language instructions
  • Code examples or templates
  • Specific formatting requirements
  • Context about the codebase or project

Example Command File

Here’s an example of a command file for generating PR descriptions:
# Write PR Description

Please analyze the recent changes in this repository and write a comprehensive pull request description.

## Requirements:
- Start with a clear, concise title
- Include a "What changed" section summarizing the key modifications
- Add a "Why" section explaining the motivation
- List any breaking changes
- Include testing information if relevant

## Format:
Use markdown formatting with appropriate headers and bullet points.

Path Resolution

Command file paths are resolved based on the configuration location:
  • Project configuration: Relative paths resolve from the project root
  • Personal configuration: Relative paths resolve from ~/.firebender/
You can also use:
  • Absolute paths: /full/path/to/command.md
  • Home directory expansion: ~/commands/my-command.md

Using Commands in Chat

Once configured, you can quickly access your commands in the Firebender chat interface by typing / (forward slash). This will show a dropdown menu with all your available commands: Commands dropdown showing available commands when typing forward slash Simply select a command from the dropdown to execute it, or continue typing to filter the list.

Best Practices