Back to Posts

Evergreen: Your PR Gardener

Evergreen helps keep pull requests green and mergeable by fixing CI failures and merge conflicts, and keeping PR branches up to date with the base branch.

Russell Horton Jul 22, 2026

You’re probably merging more code today than you were last month, or last year. As the pace of software development increases, it becomes harder to keep individual pull requests clean and mergeable. Agents make fixes, but also break linting rules. New features invalidate old tests. Other branches merge and suddenly you’ve got conflicts with main. Sometimes the hardest thing about merging a PR is keeping it green long enough to click the button.

Evergreen is an Agentic Workflow that eliminates the need to babysit PRs, add comments like @copilot pls fix tests, and constantly merge and resolve conflicts from the target branch. An intelligent workflow, tailored to your specific repo rules and customs, runs on a schedule, detecting a variety of error conditions and resolving them automatically.

Because every repo defines “mergeable” differently, Evergreen is installed by an agent that reads repo history, learns local rules, asks for your preferences, and creates a workflow tailored to the repo.

Installation

Ask an agent to research your repo and guide you through the installation:

The installer will:

1. Read the target repo’s guidance, workflows, skills, settings, and last 50 closed PRs.
2. Infer the repo’s mergeability policy and ask you to confirm it.
3. Copy workflows/evergreen.md and workflows/shared/ into .github/workflows/.
4. Configure repo policy in .github/workflows/shared/evergreen/repo-policy.md.
5. Run gh aw compile and include the compiled .lock.yml.
6. Create labels, secrets, or settings changes when you approve and permissions allow.
7. Open an installation PR.

After installation, apply the evergreen label to any PR you want Evergreen to target.

Keep in touch

Please reach out on the GitHub Next Discord and let us know how Evergreen is working for you.