Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions openhands/usage/customization/repository.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
description: You can customize how OpenHands interacts with your repository by creating a `.openhands` directory at the root level.
---

## Skills (formerly Microagents)

Check warning on line 6 in openhands/usage/customization/repository.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/customization/repository.mdx#L6

Did you really mean 'Microagents'?

Skills allow you to extend OpenHands prompts with information specific to your project and define how OpenHands
should function. See [Skills Overview](/overview/skills) for more information.
Expand Down Expand Up @@ -45,3 +45,23 @@

exit 0
```


## Stop Script

You can add a `.openhands/stop.sh` file, which will run every time the agent finishes a task (i.e., when the agent emits an `AgentFinishAction` / transitions to the `FINISHED` state).

- Runs inside the sandbox/runtime environment
- Runs from the repository root (best-effort via `git rev-parse --show-toplevel`)
- Times out after 10 minutes

For example:

```bash
#!/bin/bash

# Example: write a simple summary marker for downstream automation

echo "OpenHands finished at $(date -Iseconds)" >> .openhands/finish.log
```