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.
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 && ./aeonOpen 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.
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 68 skills by pack →
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.
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
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.
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.
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.
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.
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 inputFull reference - scheduling, var, models, authentication, notification channels, API keys, guardrails: Configuration.
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.
The deep reference lives in docs/ - jump in:
|
|
|
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 ⭐
