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).

No admin rights / can't install gh?

Grab the gh_*_macOS_arm64.zip (or your platform's binary) from github.com/cli/cli/releases and drop it on your PATH (e.g. ~/.local/bin). Then gh auth login.

---

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 74 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 ⭐}