Auto Merge / aeon skill

Bot that auto-merges green GitHub PRs

Automatically merge open PRs that have passing CI, no blocking reviews, and no conflicts

CATEGORY CoreRUNS Daily at 14:00 UTCUPDATED
Skill
Auto Merge auto-merge
Category
Core
Default schedule
Daily at 14:00 UTC
cron 0 14 * * *
Last updated

commit 7885416
Source
aeonfun/aeon/skills/auto-merge/SKILL.md MIT licensed, one prompt file

What it does

Auto Merge is an aeon skill: Automatically merge open PRs that have passing CI, no blocking reviews, and no conflicts. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

Merge open PRs that are fully green and pass an explicit safety policy. The policy exists because this skill runs autonomously with write access - a bug in the gate is a bug that ships to main.

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

Repo (owner/repo) to target. If empty, uses every repo in memory/watched-repos.md. Env: AUTO_MERGE_DRY_RUN=1 logs intent without merging. MAX_AUTO_MERGE=N caps merges per run (default 3).

What it needs

No extra API keys or MCP servers. It runs on the model you connected to aeon (a Claude subscription token, an API key, or another login).

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Auto Merge. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon auto-merge

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  auto-merge: { enabled: true, schedule: "0 14 * * *", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.