Microagents Overview - OpenHands Docs

Microagent Types

Currently OpenHands supports the following types of microagents:

General Microagents: General guidelines for OpenHands about the repository.
Keyword-Triggered Microagents: Guidelines activated by specific keywords in prompts.

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 Type	Required
`General Microagents`	No
`Keyword-Triggered Microagents`	Yes