Aeon is an autonomous agent framework that ships features to your repos, finds real vulnerabilities, and deploys live apps. It operates without approval loops, running deep research and writing new skills for itself after initial configuration.

https://t.co/dEMQToRNVB https://t.co/JAT6TSvX8s

aeonfun/aeon

Source: https://github.com/aeonfun/aeon

Star us ❤️ →              

Give it a direction and it ships the work: features, vulnerability disclosures, live apps, deep research - and new skills for itself.

No approval loops. No babysitting. Configure once, forget forever.

Quick start

You need Node.js 20+, the GitHub CLI (gh) authenticated (gh auth login), and your own copy - click Use this template on the repo page (keep it public; Actions minutes are free), or gh repo fork aeonfun/aeon --clone.

git clone https://github.com/<you>/aeon   # skip if you used `gh repo fork --clone`
cd aeon && ./aeon

Open localhost:5555 and follow the dashboard: Authenticate (any of six harnesses) → add a channel → pick skills → Run. That’s it - Aeon runs unattended. Everything is also an ./aeon command (CLI) or a /aeon chat command (setup skill).

What Aeon can do

A skill is a Markdown file: some frontmatter, then a prompt. Here’s a real one, trimmed:

# skills/digest/SKILL.md
---
name: digest
category: basics                 # which pack it belongs to
description: Generate and send a digest on a configurable topic
requires: [XAI_API_KEY?]         # ? = optional key, bare = required
var: ""                          # per-run input - "solana", "rust", "AI agents"…
mode: write
---

The prompt is the skill. You schedule it, hand it a var, chain it into others, and Haiku rates every run. How packs work: docs/skill-packs.md.

Full catalog - all 73 skills by pack →

Community skill packs →

Why “the most autonomous”

Most agent tools keep you in the loop - approve this call, review this diff. Aeon is built for the work you want done while you’re away, and it’s the only framework that does all four unattended: runs on a schedule, remembers across runs, reacts to conditions, and repairs its own broken skills. The most autonomous agent is the one that never asks.

Full comparison vs Claude Code, Hermes, and OpenClaw: SHOWCASE.md.

Proof of work

Live at aeon.fun: 2M GitHub stars secured - real vulnerabilities found, patched, and responsibly disclosed across 69 open-source repos (Alibaba, Tencent, Vercel, and more), many rated High or Critical. 68 products built on top of Aeon.

Every disclosure → · ecosystem · community packs

It ships real work

feature ships code to your repos, deploy-prototype ships live apps to Vercel, vuln-scanner finds and privately discloses real vulnerabilities, create-skill writes new skills from a sentence. How each works: CORE.md.

It heals itself

A model scores every run 1–5; heartbeat → skill-health → skill-repair → self-improve detect and fix broken skills without you, and aeon-doctor lints the config itself. How the loop closes: CORE.md.

It replicates

spawn-instance forks Aeon into a new specialized instance (var: "crypto-tracker: monitor DeFi protocols"), picks relevant skills, and registers it - no secrets propagated, billing isolated. fleet-control health-checks and dispatches across the fleet.

Guardrails

Read-only skills can’t touch the repo, irreversible actions fail closed, an optional Fleet Watcher gates every run, and secrets stay off the command line. Details: Configuration.

Configure

Everything lives in aeon.yml - schedules (standard UTC cron), the per-skill var input, model, auth, notification channels, and API keys:

skills:
  digest:
    enabled: true
    schedule: "0 14 * * *"    # daily 2pm UTC
    var: "solana"             # per-run input

Full reference - scheduling, var, models, authentication, notification channels, API keys, guardrails: Configuration.

Integrate Aeon

An Aeon instance is just a GitHub repo + Actions, so GitHub’s API is Aeon’s API - one GitHub App drives your users’ instances (dispatch skills, edit config, write sealed secrets) with no PATs or LLM billing on your side.

Full walkthrough - App setup, tenant isolation, driving skills, shipping your own pack: ADK - Aeon Developer Kit.

Docs

The deep reference lives in docs/ - jump in:

Community

We love contributors

We're excited to meet you.
Every bug fix, new skill, or doc tweak makes Aeon better. Big PRs and small ones, both welcome.

📝 Contributing guide  ·  💬 Say hi on X

_{MIT · Support the project: 0xbf8e8f0e8866a7052f948c16508644347c57aba3 ⭐}