Microagent Types

Currently OpenHands supports the following types of microagents:

To customize OpenHands’ behavior, create a .openhands/microagents/ directory in the root of your repository and add <microagent_name>.md files inside. For repository-specific guidelines, you can ask OpenHands to analyze your repository and create a comprehensive repo.md file (see General Microagents for details).

Loaded microagents take up space in the context window. These microagents, alongside user messages, inform OpenHands about the task and the environment.

Example repository structure:

some-repository/
└── .openhands/
    └── microagents/
        └── repo.md            # General guidelines
        └── trigger_this.md    # Microagent triggered by specific keywords
        └── trigger_that.md    # Microagent triggered by specific keywords

Microagents Frontmatter Requirements

Each microagent file may include frontmatter that provides additional information. In some cases, this frontmatter is required:

Microagent TypeRequired
General MicroagentsNo
Keyword-Triggered MicroagentsYes