# aeon - the most autonomous agent framework aeon is an open-source, MIT-licensed autonomous agent framework. Give it a direction and it leverages 86 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. > Not affiliated with AEON, the agentic-economy payments network, or with > aeon-toolkit, the Python time-series machine-learning library. ## What aeon is With aeon **you own everything**: your repo, your keys, your GitHub Actions, your memory. It is a set of GitHub Actions workflows plus a Next.js dashboard; Aeon Connect hosts that dashboard and a remote MCP server (https://www.aeon.fun/connect/mcp) that drives your own agent from ChatGPT, Claude or any MCP client. There is no hosted runtime and no public REST endpoint to call - runs happen on your own GitHub Actions. The unit of work, and of integration, is a **skill**: a `SKILL.md` file with a schedule and explicit when-to-use guidance. Two files define an agent: - `SOUL.md` - its voice and worldview. - `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: - **Scheduled briefs and digests** - priority briefs, research digests, changelogs. - **Continuous monitoring** - markets, onchain 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. ## Get started **In the browser (recommended):** [Aeon Connect](https://www.aeon.fun/connect). Sign in with GitHub, create your aeon repo (a public fork or a private copy), install the Aeon Connect GitHub App on that one repo, connect a model, and pick skills. No clone, no terminal. This is the homepage's RUN NOW button. **From a coding agent:** paste one line into Claude Code, Codex, Hermes or OpenClaw: > read https://www.aeon.fun/skills/aeon.md and follow the instructions to set up your aeon agent That hosted skill sends the operator to Aeon Connect, or runs the terminal setup for them. The same one-line command is on the homepage. **From the terminal:** `git clone https://github.com/aeonfun/aeon && cd aeon && ./aeon init` (needs Node.js 20+ and the GitHub CLI). ## Machine-readable resources - [Aeon Connect](https://www.aeon.fun/connect) - the hosted dashboard: start and drive an aeon instance in the browser - [Aeon Connect MCP](https://www.aeon.fun/connect/mcp) - drive your own agent (run skills, read runs, output and memory) from ChatGPT, Claude or any MCP client; Streamable HTTP with OAuth (GitHub sign-in). Claude Code: `claude mcp add --transport http aeon https://www.aeon.fun/connect/mcp` - [aeon docs MCP](https://www.aeon.fun/mcp) - public, read-only Model Context Protocol server for aeon's docs and skills (Streamable HTTP); server card at [/.well-known/mcp.json](https://www.aeon.fun/.well-known/mcp.json) - [OpenAPI spec](https://www.aeon.fun/openapi.json) - typed description of the reachable endpoints (/ask, /mcp) for function calling - [/ask](https://www.aeon.fun/ask) - NLWeb natural-language endpoint (POST a question) - [/llms.txt](https://www.aeon.fun/llms.txt) - the llmstxt.org summary index - [/agents.md](https://www.aeon.fun/agents.md) - the agent guide with the live skill catalog - [/skills/aeon.md](https://www.aeon.fun/skills/aeon.md) - the hosted setup SKILL.md - [Agent Skills index](https://www.aeon.fun/.well-known/agent-skills/index.json) - discovery index with content digest - [API catalog](https://www.aeon.fun/.well-known/api-catalog) - RFC 9727 index of the above - [ai-catalog](https://www.aeon.fun/.well-known/ai-catalog.json) - ARD manifest of agentic resources The reachable API is v1 (URL-path versioned: `https://www.aeon.fun/v1/ask`; `API-Version` header). Responses carry standard RateLimit headers; /ask returns 429 with `Retry-After` over the soft limit. An aeon instance is driven by its own `./aeon` CLI (in its repo), which also ships as a Claude Code plugin. ## 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, 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 onchain - [Ecosystem](https://www.aeon.fun/ecosystem) - agents, products, and forks built on aeon - [More aeon products](https://www.aeon.fun/#projects) - first-party tools connecting to aeon framework - [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 - [Highlights](https://www.aeon.fun/highlights) - aeon milestones as shareable stickers, one page each - [Blog](https://www.aeon.fun/blog) - essays and dispatches ## Other projects from Aeon Inc - [OpenDia](https://github.com/aeonfun/opendia) - connect your browser to AI models - [soul.md](https://github.com/aeonfun/soul.md) - the best way to build a personality for your agent - [Minitor](https://github.com/aeonfun/minitor) - monitor the current thing. Your dashboard for the internet - [univ4-hooks](https://github.com/aeonfun/univ4-hooks) - Uniswap v4 hook registry; live catalog at https://www.aeon.fun/hooks ## Source & company - [GitHub repository](https://github.com/aeonfun/aeon) - the canonical source, MIT licensed - 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