whatisgithub

What is aesop?

matt82198/aesop — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerLicenseSetup · moderate

In one sentence

A source available system that runs teams of cheaper AI coding agents in parallel on a repository, splitting work by file and merging results under human supervision.

Mindmap

mindmap
  root((Aesop))
    What it does
      Multi agent builds
      File scoped dispatch
      Self healing daemon
    Tech stack
      Python
      SQLite
      Node.js
      Claude Code
    Use cases
      Parallel agent fleets
      Cost dashboard
      Secret scanning
    Audience
      Developers
      Team leads

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run multiple AI coding agents in parallel on separate parts of a codebase under human supervision

USE CASE 2

Track the cost, health, and activity of a fleet of autonomous coding agents from a live dashboard

USE CASE 3

Automatically back up in progress work and scan for leaked secrets before they are pushed

USE CASE 4

Bootstrap a new multi service project from a preset architecture template

What is it built with?

PythonSQLiteNode.jsClaude Code

How does it compare?

matt82198/aesop0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires an npx install plus copying skill files into a Claude Code configuration folder before first use.

PolyForm Strict License: you may read, run, and use the software, but you cannot modify it or redistribute it without the author's permission.

So what is it?

Aesop is a system that runs autonomous AI coding agents on a repository, coordinating multiple smaller AI workers to build software largely on their own. It picks tasks from a backlog, splits the work so each agent owns a separate set of files, runs the agents in parallel, checks the results before merging them, and remembers what it learned for the next round. Its state is saved to disk, using SQLite plus files rendered into git, so progress survives a machine restart and can be shared across a team. By default it relies mostly on Anthropic's cheaper Haiku model to keep costs down, but it can also connect to other AI backends such as Ollama or OpenRouter, and it adjusts how strict its safety checks are depending on how capable the connected model is. The project claims it was used to build a large part of its own codebase, over 220 merged changes across many commits, through its own automated build cycle, supervised by a human who sets goals and approves things like publishing new versions. It includes a command line dashboard for watching agent activity, cost, and a task board in real time, a health check tool that reports whether the environment is set up correctly, and a background process that regularly backs up work, scans for accidentally leaked secrets, and restarts stalled agents. A pre push check can block a commit if it detects a leaked secret. Installation is done through npx, and after that the user copies a skills folder into their Claude configuration to enable two custom commands used to run the agent cycles. The project is source available under the PolyForm Strict License 1.0.0, meaning anyone can read, run, and use it, but modifying or redistributing the code is not allowed without permission from the author.

Copy-paste prompts

Prompt 1
Explain how Aesop splits backlog work across parallel Haiku agents by file ownership
Prompt 2
Walk me through setting up Aesop's dashboard to monitor agent cost and activity
Prompt 3
Show me how to configure Aesop to use a different AI backend like OpenRouter or Ollama
Prompt 4
Explain the PolyForm Strict license and what it does and does not allow me to do
Prompt 5
Summarize how Aesop's self healing daemon detects and recovers from stalled agents

Frequently asked questions

What is aesop?

A source available system that runs teams of cheaper AI coding agents in parallel on a repository, splitting work by file and merging results under human supervision.

What language is aesop written in?

Mainly Python. The stack also includes Python, SQLite, Node.js.

What license does aesop use?

PolyForm Strict License: you may read, run, and use the software, but you cannot modify it or redistribute it without the author's permission.

How hard is aesop to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is aesop for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.