Setup Openhands

Set Up OpenHands for a Repository

Work through these steps in order.

Step 1: Create AGENTS.md

Run setup-agents-md to generate a root-level AGENTS.md from the repo's actual CI workflows, build files, and documentation.

Step 2: Create .openhands/setup.sh

Create .openhands/setup.sh — a bootstrap script that runs at the start of every OpenHands session. Read the repo's CI workflows, AGENTS.md, and build files to determine the correct commands. The script should:

• Install dependencies (the project's actual install command)
• Set required environment variables
• Run any other bootstrap steps (e.g. copy .env.example to .env)

Keep it idempotent and fast. Use the real commands from CI, not generic examples.

Docs: https://docs.openhands.dev/openhands/usage/customization/repository#setup-script

Step 3: Create .openhands/pre-commit.sh

Create .openhands/pre-commit.sh — runs before every commit OpenHands makes. Read the repo's CI workflows to find the lint and test commands, then mirror them in the script. Exit non-zero on failure so the agent gets immediate feedback instead of waiting for CI.

The script should run the same checks CI runs — if CI runs ruff check and pytest, run those. If it runs cargo clippy and cargo test, run those.

Docs: https://docs.openhands.dev/openhands/usage/customization/repository#pre-commit-script

Step 4: Set up PR review

Run setup-pr-review to create the GitHub Actions workflow and walk the user through configuration.

Step 5: Verify

Confirm all files exist and are correct:

• AGENTS.md at repo root with real commands (not boilerplate)
• .openhands/setup.sh with the project's actual install/bootstrap commands
• .openhands/pre-commit.sh mirroring the CI lint/test checks
• .github/workflows/pr-review.yml with valid YAML