Agent Smith

Agent Smith

[](https://opensource.org/licenses/MIT)

Recursive Self-Similar Multi-Agent System —— Conflict-free Parallel Task Decomposition and Execution through Directory Isolation Protocol

**English** | [简体中文](README_CN.md)

---

Introduction

**Agent Smith** is a general-purpose multi-agent collaboration framework that enables multiple AI agents to work in parallel without conflicts through a strict directory isolation protocol.

Core Design Principles:

• Self-Similarity: Each agent (Smith) follows the same protocol and can recursively spawn child agents
• Conflict-Free Parallelism: Directory isolation ensures multiple agents can work simultaneously without interference
• Task Decomposition: Automatically breaks down complex tasks into parallelizable subtasks
• Platform Agnostic: Can run on any system or platform that supports multi-agent execution

---

Quick Start

Installation

**Option 1: Claude Code Skill (Recommended)**

Copy the `agent-smith` directory to Claude Code's skills directory:

# macOS / Linux
cp -r agent-smith ~/.claude/skills/

# Windows (PowerShell)
Copy-Item -Recurse agent-smith $env:USERPROFILE\.claude\skills\

**Option 2: Standalone Usage**

Copy the `.agent-smith/` directory structure to your project:

cp -r .agent-smith-template ./my-project/.agent-smith

Usage

1. **Initialize the Matrix**

   Create the `.agent-smith/` structure in your working directory:

   mkdir -p .agent-smith/smiths/smith-root/{inbox,private,outbox,children}
   mkdir -p .agent-smith/results

2. **Define the Task**

   Create a task file in the root agent's `inbox/` directory:

   # task-001.md
   ## Task: AI Agent Market Research
   
   ### Objective
   Comprehensive understanding of AI Agent market landscape
   
   ### Subtasks
   1. Market trend analysis
   2. Key vendor research
   3. Technology development trac