aeonaeon

Cost

Run a public Aeon instance with zero extra infrastructure cost using free GitHub Actions minutes and a Claude subscription.

A public Aeon repository on a free GitHub account, authenticated with an existing Claude Pro or Max subscription (CLAUDE_CODE_OAUTH_TOKEN), costs $0 in extra infrastructure.

Why Public Instances Are Free

  • Unlimited public Actions minutes: GitHub provides unlimited free Actions minutes for public repositories on standard runners.
  • Zero hosting overhead: No VPS, no managed database, and no background daemon - only Git, GitHub Actions, and your model credential.

Private Repository Minutes

If you create a Private copy (in Aeon Connect or via ./aeon init --private) to keep your memory/ and logs private, runs draw from your GitHub account's monthly Actions quota:

GitHub PlanIncluded Minutes / MonthOverage Rate (Linux)
Free2,000N/A
Pro / Team3,000$0.008 / min

Levers to Reduce Usage

  1. Widen the scheduler tick: Change the cron in .github/workflows/scheduler.yml from */5 to */15 or 0 *.
  2. Disable unused skills: Any skill with enabled: false in aeon.yml consumes zero minutes and zero tokens.
  3. Tier models by task: Keep claude-sonnet-5-5 as the default, reserve claude-opus-5-5 for deep reasoning skills, and let Haiku handle post-run scoring.
  4. Audit token spend: Inspect memory/token-usage.csv or enable spend-watch to spot high-burn skills.

On this page