# AI Slaves

> Open-source agent tooling that drains your todo list while you sleep. Two pieces: a slash-command skill for solo agents (Codex and Claude Code), and a parallel orchestrator that runs many agents at once against a shared queue.

## What it is

AI Slaves is a developer tool for people who already use Claude Code or OpenAI Codex CLI. It reads a todo source (Notion page, Markdown file, GitHub issues), claims an item, runs it as a goal with a real success check, marks it done, and moves on. When the queue is empty it suggests what you should work on next.

The whole thing is two repos, both MIT, both free:

- AI Slaves (solo): https://github.com/OmarDadabhoy/ai-slaves
- AI Slaves Sweeper (swarm): https://github.com/OmarDadabhoy/ai-slaves-sweeper

## How it works

1. Point it at a todo source. Today: Notion pages with checkbox blocks, local Markdown files with `- [ ]` lines, GitHub issues.
2. Run `/ai-slaves` inside Codex or Claude Code (solo) or `sweeper` (swarm).
3. The agent claims an item, dispatches a sub-agent to do the work, verifies the result, and emails or writes a handoff document.
4. The checkbox gets ticked. Loop.

The Sweeper runs N agents in parallel against the same queue with a claim-lock so two slaves never grab the same task. Mix Codex and Claude as workers. Watch mode polls the queue for new items.

## Audience

Solo founders, indie hackers, and small teams who already live inside an AI coding agent. People with a todo list that never drains and one too many half-finished projects.

## Install

Solo: clone the repo, symlink the skill into `~/.claude/skills/ai-slaves/` (or `~/.codex/skills/`), then run `/ai-slaves` inside Claude Code or Codex.

Sweeper: `git clone https://github.com/OmarDadabhoy/ai-slaves-sweeper && cd ai-slaves-sweeper && ./sweep --watch --workers 4`.

Full setup steps and supported todo sources live in each repo's README.

## Pricing

Free. MIT licensed. You bring your own Claude or Codex subscription; AI Slaves itself charges nothing.

## Links

- Site: https://ai-slaves.com
- Solo repo: https://github.com/OmarDadabhoy/ai-slaves
- Sweeper repo: https://github.com/OmarDadabhoy/ai-slaves-sweeper
- Author: Omar Dadabhoy (Potarix, YC alum)