Aeon Update / aeon skill

Keep your agent synced with upstream

Pull framework updates from the upstream Aeon repo into this instance - 3-way merges canon's new commits into a PR, never clobbering operator config.

CATEGORY CoreRUNS Weekly on Monday at 11:00 UTCUPDATED
Skill
Aeon Update aeon-update
Category
Core
Default schedule
Weekly on Monday at 11:00 UTC
cron 0 11 * * 1
Last updated

commit c0cb7c4
Source
aeonfun/aeon/skills/aeon-update/SKILL.md MIT licensed, one prompt file

What it does

Aeon Update is an aeon skill: Pull framework updates from the upstream Aeon repo into this instance - 3-way merges canon's new commits into a PR, never clobbering operator config. 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.

This is the fleet's downstream updater - the counterpart to fork-fleet. fork-fleet looks outward from the parent to find work in the forks worth pulling up; this skill runs inside an instance and pulls the parent's shipped framework changes down - new skills, script/harness fixes, workflow and doc updates - and lands them as a reviewable PR. It is how an instance stays current with aeonfun/aeon without a hand-run rsync-overlay rebase.

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.

Mode selector; space-separated tokens, order-independent, all optional:

  • mode (sync | report, default sync) - sync opens a PR with the framework changes; report computes the delta and notifies, mutating nothing (dry run).
  • repo=owner/name - override the upstream source repo (else auto-resolved from this instance's parent, falling back to aeonfun/aeon).
  • reset=<sha|fork-point> - force the stored baseline to <sha> (or the merge-base with upstream) before running. Recovery / backfill lever.

Empty ⇒ sync from the auto-resolved upstream. Examples: ` · report · repo=aeonfun/aeon · reset=fork-point`.

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 Aeon Update. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon aeon-update

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

skills:
  aeon-update: { enabled: true, schedule: "0 11 * * 1", var: "" }

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