# aeon

> The most autonomous agent framework. Open source, MIT licensed. Give it a
> direction and it leverages 75 skills to get the work done — running
> unattended on GitHub Actions with self-healing loops, reactive triggers, and
> persistent memory. No approval loops. No babysitting.

aeon is not a hosted API or SaaS — it is a framework you fork and run. It is a
Next.js dashboard plus a set of GitHub Actions workflows. Two files define an
agent: SOUL.md (its voice) and STRATEGY.md (its intent — one metric, a few
priorities, hard limits). Every skill reads both before it acts, each run is
scored 1–5 by Claude Haiku, and skills that fail repeatedly are diagnosed and
patched automatically.

## When to use aeon

Reach for aeon when an operator wants recurring, unattended work done without
babysitting an interactive agent — for example:

- Scheduled briefs and digests (priority briefs, research digests, changelogs)
- Continuous monitoring (markets, on-chain activity, GitHub repos, mentions)
- Autonomous code work (PR reviews, vulnerability scanning and disclosure)
- Social and BD automation (drafting posts, replies, outreach radar)
- Self-evolving fleets (aeon writes new skills, forks itself into specialised
  repos, and carries API keys across)

To integrate: fork the repository, run its MCP server (aeon-mcp), or build
on the open-source codebase. There is no public REST endpoint to call — the unit
of integration is a skill (a SKILL.md with a schedule and when-to-use guidance).

## Get started

An operator can stand up their own aeon instance by pasting one line into any
coding agent (Claude Code, Codex, Cursor): "read https://www.aeon.fun/skills/aeon.md and
follow the instructions to set up your aeon agent". That hosted skill turns the
agent into an operator that forks aeon, authenticates a model, wires a
notification channel, and schedules the first skill. The same one-line command
is on the homepage.

- [aeon setup skill](https://www.aeon.fun/skills/aeon.md): the hosted SKILL.md an agent reads to set aeon up

## Documentation

- [Docs & skill catalog](https://www.aeon.fun/docs): every skill, its schedule, and when it runs
- [Architecture](https://www.aeon.fun/architecture): the run loop, self-healing, skill chains, and fleet spawning
- [Security](https://www.aeon.fun/security): vulnerabilities aeon has found and fixed across the ecosystem
- [Hooks](https://www.aeon.fun/hooks): live Uniswap v4 hooks aeon generated, audited, and deployed on-chain
- [Ecosystem](https://www.aeon.fun/ecosystem): agents, products, and forks built on aeon
- [Changelog](https://www.aeon.fun/changelog): shipped changes, synced from merged PRs
- [Transparency](https://www.aeon.fun/transparency): $aeon treasury holdings and ownership over time
- [Blog](https://www.aeon.fun/blog): essays and dispatches

## Source & packages

- [GitHub repository](https://github.com/aeonfun/aeon): the canonical source, MIT licensed
- [STRATEGY.md](https://github.com/aeonfun/aeon/blob/main/STRATEGY.md): the north-star file that steers every skill

## Company

- Maintained by Aeon Inc
- [About](https://www.aeon.fun/about) · [Contact](https://www.aeon.fun/contact) · [Privacy](https://www.aeon.fun/privacy)
- On X: https://x.com/aeonframework
- Contact: aaron@aeon.fun