← all repositories
aeonfun/aeon

The AI agent that runs on GitHub Actions and wants you to ignore it

Most AI agents need a babysitter; Aeon runs scheduled jobs on GitHub Actions and prefers you never check in.

722 stars Shell AgentsCoding Assistants
aeon
Velocity · 7d
+22
★ / day
Trend
accelerating
star history

What it does

Aeon is a TypeScript framework that parks autonomous AI agents inside GitHub Actions. You pick from 156 skills—research digests, PR reviews, market alerts, social posts—and set a schedule. The framework dispatches workflows, scores its own output, detects when a skill degrades, and patches failing skills without intervention. It is explicitly built for background work you want finished while you are asleep, not for live pair-programming.

The interesting bit

By treating GitHub Actions as both runtime and infrastructure, Aeon eliminates servers to maintain and processes to keep alive. It can also spawn child instances of itself through fork-fleet and spawn-instance, spinning up isolated specialists—say, one for crypto monitoring and another for repository hygiene—that operate from their own forks without sharing secrets.

Key highlights

  • 156 independently schedulable skills across research, development, crypto, social, and meta-categories.
  • A self-healing loop that monitors skill health, scores output quality, and fixes broken skills automatically.
  • Persistent memory across runs and reactive triggers that fire when conditions change, not merely on a cron cadence.
  • An optional “soul” system: drop SOUL.md and STYLE.md files into a soul/ directory to make every skill write in a consistent voice.
  • A local Next.js dashboard that delegates all heavy lifting to the GitHub CLI; the actual agent logic runs entirely inside Actions using a Claude subscription or Anthropic API key.

Caveats

  • The dashboard is tightly coupled to the GitHub CLI and cannot manage secrets or dispatch workflows without it present on the same machine.
  • Spawned fleet instances do not inherit secrets, so each fork requires its own manual key configuration before it can run.
  • The authors concede the tool is not for interactive coding—you still want Claude Code for that—meaning Aeon is strictly a batch automation layer.

Verdict

Worth a look if you have recurring tasks—morning briefs, repo hygiene, market digests—that do not need you in the loop and can run on infrastructure you already pay for. Skip it if you are looking for an interactive coding companion; the README itself admits Claude Code still wins there.

Frequently asked

What is aeonfun/aeon?
Most AI agents need a babysitter; Aeon runs scheduled jobs on GitHub Actions and prefers you never check in.
Is aeon open source?
Yes — aeonfun/aeon is open source, released under the MIT license.
What language is aeon written in?
aeonfun/aeon is primarily written in Shell.
How popular is aeon?
aeonfun/aeon has 722 stars on GitHub and is currently accelerating.
Where can I find aeon?
aeonfun/aeon is on GitHub at https://github.com/aeonfun/aeon.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.