Skip to main content

Microagents Overview

Microagents are specialized prompts that enhance OpenHands with domain-specific knowledge, repository-specific context and task-specific workflows. They help by providing expert guidance, automating common tasks, and ensuring consistent practices across projects.

Microagent Categories

Currently OpenHands supports two categories of microagents:

A microagent is classified as repository-specific or public depending on its location:

  • Repository-specific microagents are located in a repository's .openhands/microagents/ directory
  • Public microagents are located in the official OpenHands repository inside the /microagents folder

When OpenHands works with a repository, it:

  1. Loads repository-specific microagents from .openhands/microagents/ if present in the repository.
  2. Loads public knowledge microagents triggered by keywords in conversations
  3. Loads public tasks microagents when explicitly requested by the user

You can check out the existing public microagents at the official OpenHands repository.

Microagent Format

All microagents use markdown files with YAML frontmatter that have special instructions to help OpenHands activate them.

Check out the syntax documentation for a comprehensive guide on how to configure your microagents.