Aeon is an MIT-licensed framework that turns a GitHub repository plus Actions into an unattended agent, firing Markdown-file skills on cron, reactive triggers, or chains through any of nine coding-agent harnesses.
Aeon has the deepest third-party unattended-agent trigger surface I have found, and the least governance: the project’s own pitch, “no approval loops”, is the caution.
What it is #
An instance is a template copy of the aeon repo: skills (one SKILL.md prompt file each, 86 bundled), memory as committed Markdown, and an aeon.yml holding cron schedules. A scheduler workflow ticks every five minutes and dispatches due skills to GitHub Actions, where they run through a harness adapter (Claude Code by default, plus Grok, Codex, Pi, Vibe, Kimi, fx, Cursor, and Hermes) against ten model gateways including a Claude subscription token. Every run gets a Haiku quality score, failures file structured issues in the repo, and three consecutive failures auto-open a repair PR, which is the self-healing loop. It is built by Aaron Elijah Mars (Aeon Inc), and deployment is a fork or template copy, so your repo is the runtime and your secrets stay in your repo’s encrypted store.
Status #
Active and single-maintainer. 773 stars as of 2026-10-13, 291 forks and 1,499 commits as of 2026-10-27, created 2026-03-04 and pushed 2026-10-26. The maintainer wrote about 83% of tracked contributor commits, and there is exactly one tagged release (v0.1.0, 2026-07-09), so development is trunk-based on main. A Hacker News search returned no coverage as of 2026-10-27, and the fork count is inflated as an adoption signal because every deployed instance is a fork by design. The project’s proof-of-work page self-reports 147 vulnerability findings across 109 repositories securing 5.3M stars (counts as of 2026-10-27, page star counts dated October 24, 2026) with a link per fix, substantial evidence that is curated by the project itself.
Strengths #
- The trigger surface is the category’s deepest outside the vendors: five-minute cron, reactive triggers on run metrics (consecutive failures, success rate, last status), skill chains with parallel steps and score-gated routing, and Telegram inbound with slash commands plus an instant webhook mode.
- Git is the database: memory, run state, config, and the failure tracker are committed files, so the whole agent is inspectable and revertible with git alone.
- Nine harnesses behind one run contract and ten gateways mean a skill written once fires on any CLI, with a Claude subscription token as one of the credential options.
- The self-healing loop (score every run, file issues, auto-repair after three failures) is the most complete automated-maintenance story in this category.
Cautions #
- The project is entangled with a crypto token: the README links a $aeon token page and a wallet address, bundled skills move onchain funds (distribute-tokens) and deploy Uniswap v4 hooks that carry a mandatory 10 bps AeonFee, and several of the ten gateways are crypto-billed.
- Bus factor: one maintainer, one tagged release, and no third-party documentation.
- “No approval loops” is the design stance: auto-merge merges green PRs up to three per run, and cross-repo skills want a classic PAT with repo and workflow scopes.
- Skill blast radius is a self-declared frontmatter hint, not a sandbox: the docs pair the hint with a CI parity check and a bwrap sandbox that covers read-only-mode skills only, so nothing technical stops a mislabeled mutating skill.
- No independent coverage or benchmarking exists as of 2026-10-13, so every quality claim traces back to the project’s own pages.
Pricing #
Free and MIT-licensed; there is no Aeon tier. Your costs are GitHub Actions minutes (free on public repos, metered on private) plus model inference on whichever gateway you connect, and the hosted Aeon Connect dashboard is free and stores no keys.
Compared to #
- GitHub Agentic Workflows: the vendor-built Actions layer compiles guarded workflows with cost caps and a firewall; Aeon is broader (chat inbound, run-metric triggers, self-healing, any harness) but swaps guardrails for self-declared capability hints.
- Claude Code routines: hosted scheduled sessions inside a Claude subscription with no repo artifacts; Aeon is repo-native, runs on your minutes, and keeps state in git.
- n8n: the SaaS-webhook canvas with an agents preview; Aeon is CLI-and-repo-native with skills instead of nodes and no hosted execution path.
Bottom line #
Recommended for solo operators who want an always-on agent on their own Actions minutes, will read every SKILL.md before enabling it, and accept a single-maintainer token-adjacent project. Not for teams that need a governed execution layer (gh-aw is the answer there) or anyone unwilling to take a self-reported track record on faith.
Changes #
- 2026-10-08 - Created.
- 2026-10-11 - Refreshed the repository counters (forks 279 to 280) and re-dated the as-of claims after the docs, security page, founder page, and coverage search all re-verified unchanged.
- 2026-10-13 - Corrected the bundled-skill count from 85 to 86 against the current docs; the remaining doc claims and all counters re-verified unchanged.
- 2026-10-22 - Fully re-verified in rotation with every cited URL re-fetched: the docs (nine harnesses, ten gateways, the 86-skill catalog), the repo page (MIT, template deployment, the token links still in the README and footer), the founder site, and the empty HN footprint all re-confirmed; the proof-of-work counters moved (141 findings across 105 repositories to 143 across 107) and the repository counters refreshed (293 forks, 1,486 commits, pushed 2026-10-22).
- 2026-10-27 - Fully re-verified in rotation with every cited URL re-fetched: the docs (nine harnesses, ten gateways, the 86-skill catalog re-confirmed against skills.json), the repo README (the $aeon Bankr button and the footer wallet address still present), the security page (findings moved to 147 across 109 repositories securing 5.3M stars), the founder site, and the still-empty HN footprint all re-confirmed; the blast-radius caution now names the docs’ bwrap read-only sandbox and CI parity check, and the counters refreshed (291 forks, 1,499 commits, pushed 2026-10-26).
See also #
- GitHub Agentic Workflows - the guardrail-first way to run agents on the same Actions runners
- Claude Code routines - the hosted scheduler for Claude-subscribed teams
- n8n - webhook-first automation with a preview agents layer
- Claude Code - the default harness every Aeon run drives
References #
https://github.com/aeonfun/aeon - repository scale, template deployment model, MIT license, single release, founder line, as of 2026-10-08
https://www.aeon.fun/docs - architecture, the 86-skill catalog, five-minute scheduler, reactive triggers, chains, harnesses, and gateways (re-fetched 2026-10-27)
https://www.aeon.fun/security - the self-reported vulnerability-disclosure record (147 findings, 109 repositories, 5.3M stars, counts re-fetched 2026-10-27)
https://aaronjmars.com - the founder’s own description of Aeon, MiroShark, and Hyperstitions (re-fetched 2026-10-27)
https://hn.algolia.com/api/v1/search?query=aeonfun&tags=story - the coverage search that returned no hits on the project, as of 2026-10-27
https://api.github.com/repos/aeonfun/aeon - exact counters (created 2026-03-04, 773 stars as of 2026-10-13, 291 forks, 1,499 commits, pushed 2026-10-26) and the single v0.1.0 release (re-verified 2026-10-27)