aeon-loop

Aeon Loop

/claude /plugin for Autonomous task execution for Claude Code. Start a task, walk away, return to find it complete.

Features Table

Feature	ralph-loop	aeon-flux	mind-glaive	aeon-loop
Loop engine	✅	-	-	✅
Abort system	-	✅	-	✅
Context persistence	-	partial	✅	✅
Subagent coordination	-	✅	-	✅ (enhanced)
Pattern learning	-	-	✅	✅
Attention preservation	-	✅	✅	✅
Action philosophy	-	✅	-	✅
Persistent planning	-	-	-	✅
PRD generation	-	-	-	✅

What Is This?

Aeon Loop is a Claude Code plugin that enables autonomous, multi-iteration task execution. It combines:

Source Plugin	What It Contributes
Ralph Loop	Autonomous iteration engine (Stop hook re-injects prompt)
Aeon Flux	Abort system + "action over explanation" philosophy
Mind Glaive	Context persistence across iterations and compactions
Persistent Planning	Manus-style persistent markdown planning

Quick Start

v1 → v2 breaking change: the hand-rolled aeon-loop install --scope user flow was removed. Installation is now handled automatically by either the Claude Code plugin marketplace or npm's postinstall. See CHANGELOG.md for migration details.

Option A: Claude Code Plugin Marketplace (Recommended)

/plugin marketplace add TheGlitchKing/aeon-loop
/plugin install aeon-loop@aeon-loop-marketplace
/aeon-flux

Option B: Project-level npm install

Pins the version in package.json, visible to teammates, CI, and LLMs reading the repo.

npm install --save-dev @theglitchking/aeon-loop

Postinstall writes .claude/aeon-loop.json (update policy: nudge) and registers a SessionStart update-check hook in .claude/settings.json (skipped if the marketplace plugin is already enabled in ~/.claude/settings.json).

Update management

Every install ships with an update policy. Default is nudge — one-liner notification at session start when a newer version is available, no automatic changes.

aeon-loop status          # installed / latest / policy / hook state
aeon-loop policy auto     # auto-update on session start
aeon-loop policy nudge    # one-liner nudge only (default)
aeon-loop policy off      # silent
aeon-loop update          # update now

Slash-command parity: /aeon-loop:status, /aeon-loop:policy <mode>, /aeon-loop:update, /aeon-loop:relink.

Note: This package includes both aeon-loop and aeon-flux bundled together. The unified workflow guides you through everything.

The Workflow

When you run /aeon-flux, you'll be guided through a complete project lifecycle:

/aeon-flux
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│ PHASE 0: EXPLORATION (Optional)                             │
│                                                             │
│ "I see this is an existing project.                        │
│  Would you like me to explore the codebase first?"         │
│                                                             │
│ 1.1. Full analysis (structure, patterns, architecture)     │
│ 1.2. Quick overview                                        │
│ 2.1. Skip - I'm familiar with this codebase               │
│ 2.2. Skip - This is a new project                          │
│                                                             │
│ → Launches parallel agents to explore                      │
│ → Saves report to .planning/exploration/report.md          │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│ PHASE 1: DISCOVERY                                          │
│                                                             │
│ "What would you like to build?"                            │
│                                                             │
│ → Asks 3-5 clarifying questions with numbered options      │
│ → You respond: "1.1, 2.2, 3.1"                             │
│ → Continues until 90% confident                            │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│ PHASE 2: PRD CREATION                                       │
│                                                             │
│ → Generates Product Requirements Document                   │
│ → Right-sized user stories (completable in one iteration)  │
│ → Saves to .planning/[task-slug]/prd.md                    │
│                                                             │
│ "Does this PRD capture what you want?"                     │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐