Aeon

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

You need Node.js 20+ and the GitHub CLI (gh). Then:

git clone https://github.com/aeonfun/aeon && cd aeon
./aeon init

./aeon init does the rest and tells you what it did at each step: signs you in to GitHub, creates your own repo from the template (public by default - Actions minutes are free; --private if you prefer), points this folder and gh at it, turns on GitHub Actions, stores your GitHub token for runs, connects a model (any of nine harnesses: a Claude subscription, an API key, or one OpenRouter key) and, if you want, links Telegram. It is safe to re-run: every step checks first and skips what is already done. Then ./aeon opens the same dashboard locally at localhost:5555 to pick skills and Run. bin/onboard re-checks the whole setup any time (read-only).

1. Click Use this template on the repo page (keep it public; Actions minutes are free). A template copy starts with GitHub Actions on. If you fork by hand instead, open the fork's Actions tab and enable workflows first: a fork starts with Actions off and its schedules never fire until you do. (Aeon Connect forks public instances and turns Actions on for you.)

2. Clone it and point gh at it - without this, secrets you set land on aeonfun/aeon instead of your repo:

   gh auth login --web -s workflow
   git clone https://github.com/<you>/aeon && cd aeon
   gh repo set-default <you>/aeon
   ./aeon
   

3. In the dashboard: Connect a model -> add a channel -> pick skills -> Run.

Everything is also an ./aeon command (CLI) or a /aeon chat command (setup skill, installable as a Claude Code or Codex plugin). For skills that reach other repos, add a classic PAT with repo + workflow as GH_GLOBAL (details).

You don't need either: Aeon Connect sets everything up from the browser. For the terminal path, 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
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.

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

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