by aaronjmars
The most autonomous agent framework. No approval loops. No babysitting. Configure once, forget forever.
# Add to your Claude Code skills
git clone https://github.com/aaronjmars/aeonMost agent tools put you in the driver's seat — approve this tool call, review this diff, confirm this action. That's useful for interactive work. But there's a whole class of tasks where you just want the work done while you're not there: morning briefs, market monitoring, PR reviews, research digests, security scans.
Aeon is built for that. Here's how it compares:
| | Aeon | Claude Code | Hermes | OpenClaw | |--|------|------------|--------|---------| | Runs unattended on a schedule | Yes | No | Yes | No | | Self-heals when skills fail | Yes | No | No | No | | Monitors its own output quality | Yes | No | No | No | | Persistent memory across runs | Yes | No | Limited | No | | Reactive triggers (auto-responds to conditions) | Yes | No | No | No | | Fixes its own broken skills | Yes | No | No | No | | Zero infrastructure | Yes (GitHub Actions) | Local | Self-hosted | Self-hosted | | Reasons about tasks | Yes | Yes | Yes | Yes |
The key difference: other agents are interactive tools you use. Aeon is an autonomous system you configure and walk away from. It decides when to run, what to check, and when to bother you. It scores its own output, detects degradation, and patches failing skills without intervention.
This isn't better for everything — you still want Claude Code for writing code interactively. But for the 90% of recurring tasks that don't need you in the loop, the most autonomous agent is the one that never asks.
For a comparison against the broader agent ecosystem (AutoGen, CrewAI, n8n, LangGraph) and a list of active forks running in production, see SHOWCASE.md.

git clone https://github.com/aaronjmars/aeon
cd aeon && ./aeon
No comments yet. Be the first to share your thoughts!
Click on http://localhost:5555 to open the dashboard in your browser. From there:
var to focus each skill./onboard to confirm secrets, workflows, memory, and notifications are wired up correctly. Add --remote to fire the check inside Actions and have the checklist arrive in your notification channel.Need a skill for X? Six pre-built starters live in templates/ — crypto tracker, research digest, code reviewer, social monitor, deploy watcher, community manager. Bootstrap one with ./new-from-template <template> <skill-name> --var KEY=VALUE... and it lands in skills/ with a disabled entry in aeon.yml, ready to enable.

| Category | Skills |
|----------|--------|
| Research & Content (17) | article, digest, rss-digest, hacker-news-digest, paper-digest, paper-pick, last30, deep-research, technical-explainer, list-digest, research-brief, fetch-tweets, reddit-digest, telegram-digest, security-digest, channel-recap, vibecoding-digest |
| Dev & Code (29) | pr-review, github-monitor, github-issues, github-releases, issue-triage, auto-merge, changelog, code-health, skill-security-scan, github-trending, push-recap, repo-pulse, star-milestone, repo-article, repo-actions, repo-scanner, project-lens, external-feature, create-skill, autoresearch, search-skill, auto-workflow, deploy-prototype, vuln-scanner, workflow-security-audit, vercel-projects, spawn-instance, fleet-control, fork-fleet |
| Crypto & Markets (16) | token-alert, token-movers, token-report, token-pick, monitor-runners, on-chain-monitor, defi-monitor, defi-overview, market-context-refresh, narrative-tracker, monitor-polymarket, monitor-kalshi, polymarket-comments, unlock-monitor, treasury-info, distribute-tokens |
| Social & Writing (7) | write-tweet, reply-maker, remix-tweets, refresh-x, tweet-roundup, agent-buzz, farcaster-digest |
| Productivity (12) | morning-brief, daily-routine, evening-recap, weekly-review, weekly-shiplog, goal-tracker, idea-capture, action-converter, tool-builder, startup-idea, deal-flow, reg-monitor |
| Meta / Agent (14) | heartbeat, reflect, self-improve, skill-health, skill-evals, skill-repair, skill-leaderboard, fork-contributor-leaderboard, fork-skill-digest, skill-update-check, cost-report, rss-feed, update-gallery, onboard |
Full descriptions: skills.json — or run ./add-skill aaronjmars/aeon --list
Dependency graph: docs/skill-graph.md — visual map of how skills connect, grouped by category with the self-healing loop and content pipeline highlighted
Aeon can spawn and manage copies of itself via spawn-instance, fleet-control, and fork-fleet. Use this to run specialized instances — one for crypto monitoring, another for research, etc.
Spawn with var: "crypto-tracker: monitor DeFi protocols and token movements". The skill forks the repo, selects relevant skills, and registers it in memory/instances.json. No secrets are propagated — the new owner adds their own keys.
Set one of these — not both:
| Secret | What it is | Billing |
|--------|-----------|---------|
| CLAUDE_CODE_OAUTH_TOKEN | OAuth token from your Claude Pro/Max subscription | Included in plan |
| ANTHROPIC_API_KEY | API key from console.anthropic.com | Pay per token |
Getting an OAuth token:
claude setup-token # opens browser → prints sk-ant-oat01-... (valid 1 year)
Route requests through Bankr LLM Gateway for ~67% cheaper Opus (via Vertex AI) and access to Gemini, GPT, Kimi, and Qwen models.
BANKR_LLM_KEY as a repo secretgateway: { provider: bankr } in aeon.ymlBy default Aeon has no personality. To make it write and respond like you, add a soul:
SOUL.md — identity, worldview, opinions, interestsSTYLE.md — voice, sentence patterns, vocabulary, toneexamples/good-outputs.md — 10–20 calibration samplessoul/CLAUDE.md:## Identity
Read and internalize before every task:
- `soul/SOUL.md` — identity and worldview
- `soul/STYLE.md` — voice and communication patterns
- `soul/examples.md` — calibration examples
Embody this identity in all output. Never hedge with "as an AI."
Every skill reads CLAUDE.md, so identity propagates automatically.
Quality check: soul files work when they're specific enough to be wrong. "I think most AI safety discourse is galaxy-brained cope" is useful. "I have nuanced views on AI safety" is not.
Every skill output is automatically scored 1–5 by Haiku after each run (failed/empty → 1, excellent → 5). Scores and flags (api_error, stale_data, rate_limited) are tracked per skill in memory/skill-health/ with a rolling 30-run history.
Heartbeat is the only skill enabled by default. Runs 3x daily, checks memory/cron-state.json for failed, stuck, or chronically broken skills, stalled PRs, and missed schedules. Nothing to report → logs HEARTBEAT_OK. Something needs attention → sends one notification. Listed last in aeon.yml so it only fires when no other skill claims the slot.

heartbeat (3x daily) — detects failed, stuck, or chronically broken skillsskill-health — audits quality scores and flags API degradation patternsskill-evals — assertion-based output quality tests to catch regressionsskill-repair — diagnoses and patches failing skills automaticallyself-improve — evolves prompts, config, and workflows based on performanceSkills with schedule: "reactive" fire on conditions, not cron. If any skill fails 3x in a row, skill-repair auto-fires. The scheduler evaluates triggers after processing cron skills.
reactive:
skill-repair:
trigger:
- { on: "*", when: "consecutive_failures >= 3" }
Every