Skip to content

Aeon v0.1.0

Latest

Choose a tag to compare

@aaronjmars aaronjmars released this 09 Jul 19:30
2083bc7

Aeon is an autonomous agent framework that runs on GitHub Actions via Claude Code. Fork it, enable a few skills, schedule them — and it does the work on its own: ships features to your repos, finds and privately discloses real vulnerabilities, deploys live apps, runs deep research, and writes new skills for itself. No approval loops, no babysitting.

v0.1.0 is the first tagged snapshot — a stable, fully documented point to fork from or pin to. It's pre-1.0: the architecture is settled and the core skill set is production-ready, but interfaces may still shift before 1.0.

What's in it

The skill system — 60 core skills across 6 packs. Each is a self-contained SKILL.md prompt file with YAML frontmatter (schedule, capability mode, required keys, MCP servers). The prompt is the skill; there's no code to write. Scheduled, chained, or fired by reactive triggers through aeon.yml.

Autonomy & self-healing — a health loop scores every run 1–5, files issues on degradations, and repair skills fix them by PR. Skills declare a capability mode: read-only skills physically can't mutate the repo; irreversible actions (email, deploy, on-chain transfer) run in-run and fail closed.

Multi-provider LLM gateway — an 8-provider cascade (claude → anthropic → openrouter → bankr → usepod → venice → surplus → grok) resolved by priority, plus an optional Grok build harness. One key gets you running; add more to route around limits.

Memory & knowledge — a native OKF knowledge bundle in-place. memory/topics/ is durable, shareable living knowledge; daily logs and a structured issue tracker feed the health loop.

Interfaces — a local dashboard that manages config and pushes it to GitHub as repo secrets/vars, a headless CLI, an MCP server that exposes skills as Claude tools, a Telegram webhook for ~1s interactive control, and multi-channel notify (Telegram/Discord/Slack/email/feed).

Security posture — external content is treated as untrusted; secrets never touch the command line (secretcurl with {ENV} placeholders); every skill install is security-scanned.

Community — a public template repo with 10 community skill packs already listed in the registry, installable in one click.

Getting started

  1. Click Use this template (or fork).
  2. ./aeon to launch the dashboard on localhost:5555.
  3. Add one LLM key, enable a skill, give it a schedule.
  4. bin/onboard verifies your setup.

Full docs: README · operating manual (CLAUDE.md) · configuration reference · contributing.