Quick start
You need three things:
-
Node.js 20+ - grab the LTS installer from nodejs.org, or use a package manager:
brew install node(macOS),winget install OpenJS.NodeJS.LTS(Windows), nvm or your distro's package manager (Linux). Already have it?node -vshould print 20 or higher. -
GitHub CLI (
gh), authenticated - the dashboard uses it for everything (secrets, workflows), and./aeonchecks it before starting. Install:brew install gh(macOS),winget install --id GitHub.cli(Windows), per-distro instructions (Linux). Then rungh auth loginand follow the prompts. -
Your own copy of this repo - click Use this template at the top of the repo page - keep it public, Actions minutes are free on public repos. CLI version:
gh repo fork aaronjmars/aeon --clone.
git clone https://github.com/<you>/aeon # skip if you used `gh repo fork --clone`
cd aeon && ./aeon
Open http://localhost:5555 and follow the four steps:
- Authenticate - connect your Claude Pro/Max subscription, or paste an API key: Anthropic, Anthropic-compatible, or a gateway key (Bankr, OpenRouter, UsePod, Venice, Surplus) - routed automatically.
- Add a channel - Telegram, Discord, or Slack so Aeon can talk to you.
- Pick skills - toggle what you want, set schedules. Each skill shows the API keys and MCP servers it needs, with one-click setup.
- Run - hit Run now on any skill to try it immediately; API keys and
varvalues apply directly, no push needed. When you change config (schedules, toggles), Push commits it to GitHub in one click so Actions runs it on cron.
That's it - Aeon now runs unattended. On a public repo, GitHub Actions minutes are free. Run ./onboard anytime to verify your setup.
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). No installer, no sudo. Then gh auth login.
What Aeon can do
183 skills, grouped into 9 packs. By default the dashboard shows only the small core set; everything else is hidden until you enable its pack in the Packs view - a visibility switch that reveals a pack's skills across the UI without running anything. Putting a skill on duty stays a per-skill toggle. Every skill is independently installable, schedulable, and chainable. How packs work: docs/skill-packs.md.
| Pack | Key | Skills | Examples |
|---|---|---|---|
| 🧬 Core - self-evolution, healing, memory; always present | core |
14 | skill-repair, autoresearch, create-skill |
| 🛰️ Fleet & Replication | fleet |
8 | spawn-instance, deploy-prototype, vuln-scanner |
| 📚 Research & Content | research |
26 | deep-research, paper-digest, hn-digest |
| 💻 Dev & Code | dev |
34 | pr-review, github-monitor, auto-merge |
| 📈 Crypto & Markets | markets |
23 | token-movers, defi-overview, base-mcp |
| 🛡️ Onchain Security | hound |
15 | rug-scan, contract-audit, honeypot-check |
| ✍️ Social & Writing | social |
17 | thread-writer, reply-maker, remix-tweets |
| ✅ Productivity | productivity |
16 | priority-brief, retrospective, goal-tracker |
| 🤖 Agent Ops | agent-ops |
30 | heartbeat, cost-report, config-validator |
| Pack | Skills |
|---|---|
Core (core, 14) |
autoresearch,config-validator,cost-report,create-skill,digest,heartbeat,install-skill,onboard,priority-brief,reflect,self-improve,skill-evals,skill-health,skill-repair |
Fleet & Replication (fleet, 8) |
contributor-reward,deploy-prototype,distribute-tokens,external-feature,fleet-control,fleet-scorecard,spawn-instance,vuln-scanner |
Research & Content (research, 26) |
agent-displacement,article,article-queue,beat-tracker,channel-recap,deep-research,fetch-tweets,framework-watch,hn-digest,huggingface-trending,last30,launch-radar,list-digest,mcp-pulse,narrative-convergence,paper-digest,paper-pick,reddit-digest,research-brief,rss-digest,security-digest,technical-explainer,telegram-digest,topic-momentum,tweet-digest,vibecoding-digest |
Dev & Code (dev, 34) |
auto-merge,auto-workflow,builder-map,changelog,code-health,disclosure-tracker,ecosystem-links,ecosystem-pulse,fork-cohort,fork-fleet,fork-release,github-monitor,github-releases,github-trending,issue-triage,pr-merge,pr-review,pr-tracker,pr-triage,project-lens,push-recap,pvr-triage,pvr-watchlist,repo-actions,repo-article,repo-pulse,repo-revive,repo-scanner,search-skill,skill-triage,star-milestone,vercel-projects,vuln-tracker,workflow-audit |
Crypto & Markets (markets, 23) |
aixbt-pulse,base-mcp,beamr-route,compute-pulse,ctrl,defi-overview,fear-divergence,liquidpad-launch,market-context,monitor-kalshi,monitor-polymarket,narrative-tracker,onchain-monitor,picks-tracker,pm-manipulation,pm-pulse,price-alert,rwa-pulse,token-movers,token-pick,treasury-info,unlock-monitor,x402-monitor |
Onchain Security (hound, 15) |
approval-audit,contract-audit,deployer-trace,fund-flow,holder-concentration,honeypot-check,investigation-report,linked-wallets,lp-lock,rug-scan,tx-explain,vigil,vigil-revoke,wallet-profile,wallet-risk |
Social & Writing (social, 17) |
agent-buzz,content-performance,create-campaign,engagement-act,farcaster-digest,mention-radar,product-hunt,refresh-x,remix-tweets,reply-maker,schedule-ads,show-hn,skill-spotlight,soul-builder,syndicate-article,thread-writer,tweet-roundup |
Productivity (productivity, 16) |
action-converter,deal-flow,followup-patrol,goal-tracker,idea-capture,idea-pipeline,idea-validator,milestone-tracker,ops-recap,reg-monitor,retrospective,routine,shiplog,startup-idea,strategy-builder,tool-builder |
Agent Ops (agent-ops, 30) |
api-health,atrium-watch,batch-health,capabilities-map,contributor-leaderboard,contributor-spotlight,fleet-state,fork-digest,fork-firstrun,fork-health,frequency-guard,janitor,memory-dedupe,operator-scorecard,rss-feed,self-review,signal-verdict,skill-adoption,skill-analytics,skill-enabler,skill-freshness,skill-gap,skill-graph,skill-leaderboard,skill-scan,skill-update,sparkleware-catalog,spend-monitor,star-momentum,update-gallery |
Authoritative source: skills.json + packs.json, the dashboard Packs view, or ./add-skill aaronjmars/aeon --list. A skill's pack comes from its category: frontmatter - see docs/skill-packs.md.
Dependency graph: docs/skill-graph.md - a visual map of how skills connect.
It heals itself
Every skill output is automatically scored 1–5 by Haiku after each run. Scores and failure flags (api_error, stale_data, rate_limited) are tracked per skill in memory/skill-health/ with a rolling 30-run history. When something breaks, the loop fixes