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.

▶ Start in your browser: www.aeon.fun/connect - sign in with GitHub, connect a model, pick skills. No clone, no terminal.

🤖 Using a coding agent? Point it here: read https://www.aeon.fun/skills/aeon.md and follow the instructions to set up your Aeon agent.

Already have an agent? Drive it from ChatGPT, Claude or Cursor: add https://www.aeon.fun/connect/mcp as a connector and sign in with GitHub.

---

Quick start

In your browser (recommended): Aeon Connect. Sign in with GitHub at www.aeon.fun/connect and click Create your aeon: it makes your own repo (public = a fork of aeonfun/aeon, free Actions minutes; private = a copy, on your own minutes) and turns GitHub Actions on. Install the Aeon Connect GitHub App on that one repo (GitHub’s page opens with it pre-selected), then connect a model (a Claude subscription token from claude setup-token, an API key, a ChatGPT login, or OpenRouter in one click), pick skills, and press Run. Keys go straight into your repo’s encrypted secrets; Aeon Connect only hosts the dashboard, and every run happens on your own GitHub Actions.

Using a coding agent? Paste this 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.

Drive it from ChatGPT, Claude or Cursor. Add https://www.aeon.fun/connect/mcp as a connector (custom MCP server). Sign in with GitHub, pick which agent it can reach, then list and run skills, read their output and memory, or edit your strategy and soul from the chat. Nothing to install, no keys. Claude Code: claude mcp add --transport http aeon https://www.aeon.fun/connect/mcp. Runs still happen on your own GitHub Actions.

---

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
description: Generate and send a digest on a configurable topic
metadata:
  title: Digest
  mode: write
  category: basics               # which pack it belongs to
  var: ""                        # per-run input - "solana", "rust", "AI agents"…
  requires:
    - XAI_API_KEY?               # ? = optional key, bare = required
---

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

Full catalog - all 87 skills by pack →

Community skill packs →

Support nine harnesses: Claude, Grok, Codex, Pi, Vibe, Kimi, fx, Cursor, Hermes

The same SKILL.md runs on any of nine agent CLIs - Claude, Grok, Codex, Pi, Vibe, Kimi, fx, Cursor, Hermes - behind one run-harness contract (same result, usage, and session shape). Swap the harness; nothing else changes. How the contract works: docs/harnesses.md. GLM Coding Plan is a Claude AI Gateway hop (GLM_API_KEY), not a harness.

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: 4.7M GitHub stars secured - real vulnerabilities found, patched, and responsibly disclosed across 100+ open-source repos (Alibaba, Tencent, Vercel, and more), many rated High or Critical. 70+ 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.

---

Private by design

Muse, Grok, and Hermes Cloud run around the clock too, but on their own servers, and they train on your chats unless you opt out (Muse, Grok, Hermes Cloud). Aeon runs on your own GitHub Actions: memory is files in your repo, keys are your repo’s encrypted secrets, there is no Aeon server in the loop, and nothing is sent anywhere unless you point tracing at your own collector. Keep it fully private with a private instance (two-repo strategy) and your own model key - your model provider’s terms still apply.

The hosted MCP server is opt-in: when you connect it, Aeon Connect reads what you ask for (runs, outputs, memory) from your repo and hands it to your chat client.

---

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.

GitHub permissions: the built-in GITHUB_TOKEN covers same-repo work; add one classic PAT as GH_GLOBAL with repo + workflow scopes to drive every cross-repo, private, disclosure, and workflow-editing skill. No read:org / admin:org. See Cross-repo access. Set up with Aeon Connect? The dashboard reaches your repo through the Aeon Connect GitHub App, so no PAT is needed to get going; GH_GLOBAL is only for the cross-repo skills above.

---

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 ⭐

---

Built by Aaron Elijah Mars, founder of Aeon and MiroShark · @aaronjmars