awesome-ai-anatomy

> **NEW: [AgentSentinel](https://github.com/NeuZhou/agent-sentinel)** -- We went from studying agent anatomy to protecting it. A zero-trust local proxy that monitors, secures, and records every decision your AI agent makes. Built from the security findings of our 16+ agent teardowns. `npx agent-sentinel start` <p align="center"> <img src="assets/hero-banner.png" alt="Awesome AI Anatomy" width="100%"> </p> <p align="center"> <b>English</b> | <a href="README.zh-CN.md">简体中文</a> </p> <p align="center"> <a href="https://github.com/NeuZhou/awesome-ai-anatomy/stargazers"><img src="https://img.shields.io/github/stars/NeuZhou/awesome-ai-anatomy?style=social" alt="Stars"></a> <a href="https://github.com/NeuZhou/awesome-ai-anatomy/network/members"><img src="https://img.shields.io/github/forks/NeuZhou/awesome-ai-anatomy?style=social" alt="Forks"></a> <a href="https://twitter.com/Neuzhou_"><img src="https://img.shields.io/twitter/follow/Neuzhou_?style=social" alt="Twitter"></a> <a href="https://neuzhou.substack.com"><img src="https://img.shields.io/badge/Substack-Newsletter-orange?logo=substack" alt="Substack"></a> <img src="https://img.shields.io/badge/teardowns-16-blue" alt="Teardowns"> <img src="https://img.shields.io/badge/updated-weekly-brightgreen" alt="Updated Weekly"> <img src="https://img.shields.io/github/last-commit/NeuZhou/awesome-ai-anatomy?label=Last%20Updated" alt="Last Updated"> <img src="https://img.shields.io/badge/license-MIT-orange" alt="License"> </p> <h3 align="center">Source code teardowns of AI coding agents. Architecture diagrams, design patterns, and the stuff nobody documents.</h3> > **Claude Code** hides 18 virtual pet species inside production code that runs on your machine. > **MemPalace** got 30K stars in 4 days - with 7,600 lines of Python. > **oh-my-codex** runs 30 AI agents in parallel using git worktrees for isolation. > None of this is in the docs. We found it by reading every file. <p align="center"> <b>New teardown every Tuesday</b> · <a href="https://neuzhou.substack.com"><b>Get it in your inbox</b></a> (free) · <a href="https://twitter.com/Neuzhou_">Follow on X</a> </p> # Awesome AI Anatomy 15 AI agent projects dissected - architecture diagrams, design patterns, and the engineering decisions nobody documents. --- ## Table of Contents - [Greatest Hits](#greatest-hits) - [Project Index](#project-index) - [Cross-Project Comparison](#cross-project-comparison) - [What Makes This Different](#what-makes-this-different) - [Each Teardown Includes](#each-teardown-includes) - [Coming Next](#coming-next) - [Contributing](#contributing) - [Stay Updated](#stay-updated) --- ## Greatest Hits The 5 findings people can't stop sharing: | # | Finding | Project | Why It Matters | |---|---------|---------|---------------| | 1 | **Claude Code ships 18 virtual pet species** - a full tamagotchi system hidden in a coding agent | [Claude Code](claude-code/) | What else is hiding in tools you run with `sudo`? | | 2 | **Pi Mono's "stealth mode" mirrors Claude Code tool names** for provider compatibility | [Pi Mono](pi-mono/) | Open-source projects gaming API providers is a trend | | 3 | **MiroFish's "collective intelligence" = LLM social simulation** - agents role-playing humans on a simulated social network | [MiroFish](mirofish/) | 50K stars driven by a compelling vision of agent-based prediction | | 4 | **Lightpanda's bitcast dispatch** makes Zig act like a language with vtables - a systems trick we'd never seen before | [Lightpanda](lightpanda-browser/) | Zig comptime metaprogramming pushed to its limits | | 5 | **DeerFlow's orphan tool call bug** - 93 lines of code fix a crash that affects every LangGraph-based agent | [DeerFlow](deer-flow/) | If you use LangGraph, you probably have this bug too | > These are real findings from reading source code, not vibes from README files. Ever wondered how Claude Code manages its context window? Or why Codex CLI chose Rust and built a 17K-line sandbox? These teardowns answer questions like that by reading the actual source code. --- ## Project Index 15 AI agent source code analyses - from orchestration frameworks to coding assistants. > On mobile? Scroll right to see all columns, or tap a project name to read the full teardown. | # | Project | Stars | Language | Lines | Key Findings | Status | |---|---------|-------|----------|-------|-------------|--------| | 001 | [**Dify**](dify/) | 136K | Python + TS | 1.24M | `graphon` engine, 7+ containers, 30+ vector DBs | Published | | 002 | [**Claude Code**](claude-code/) | 109K | TypeScript | 510K | 4-layer context, hidden pet system (18 species) | Published | | 003 | [**Browser Use**](browser-use/) | 87K | Python | 53K | Raw CDP over Playwright, DOM pipeline beats screenshots 5x, skills system, custom Chromium fork | **NEW** | | 004 | [**OpenHands**](openhands/) | 71K | Python + TS | 400K | 10 condensers, 3-layer security, 487-line stuck detector | Published | | 005 | [**Cline**](cline/) | 60K | TypeScript | 560K | 3,756-line God Object, 40+ providers, YOLO mode, hooks system | Published | | 006 | [**DeerFlow**](deer-flow/) | 58K | Python + TS | 180K | 14-layer middleware, hash loop kill@5, no RBAC | Published | | 007 | [**MiroFish**](mirofish/) | 50K | Python + Vue | 39K | LLM social simulation engine for collective intelligence | Published | | 008 | [**Goose**](goose/) | 37K | Rust + TS | 198K | MCP-first bus, 5-inspector pipeline, 30+ LLMs | Published | | 009 | [**Pi Mono**](pi-mono/) | 32K | TypeScript | 147K | Game-engine arch, stealth mode as Claude Code | Published | | 010 | [**MemPalace**](mempalace/) | 30K | Python | 9K | Milla Jovovich's 4-layer memory palace, AAAK dialect debunked | Published | | 011 | [**OpenAI Codex CLI**](codex-cli/) | 27K | Rust | 549K | Queue-pair arch, Guardian AI approval, 3-OS sandbox | Published | | 012 | [**Lightpanda**](lightpanda-browser/) | 27K | Zig + Rust | 91K | From-scratch browser for AI agents, 9x Chrome | Published | | 013 | [**Hermes Agent**](hermes-agent/) | 26K | Python | 260K | Self-improving skills, FTS5 search, frozen mem | Published | | 014 | [**oh-my-claudecode**](oh-my-claudecode/) | 24K | TypeScript | 194K | 19-agent team via file IPC, Haiku→Opus routing | Published | | 015 | [**oh-my-codex**](oh-my-codex/) | 19.5K | TypeScript | 124K | 30 agents, git worktrees, plugin hook SDK, autoresearch loops | Published | | 016 | [**Guardrails AI**](guardrails-ai/) | 6.6K | Python | 18K | Validator Hub, reask self-correction loop | Published | Projects sorted by GitHub stars (descending). --- ## Cross-Project Comparison **[Interactive Comparison Tool](https://neuzhou.github.io/awesome-ai-anatomy/comparison.html)** - filter, search, and compare projects side by side. We maintain a detailed **[COMPARISON.md](COMPARISON.md)** with side-by-side analysis across all 16 projects: - Quick Reference (creator, stars, language, type, license) - Architecture patterns (agent loop, extensibility, deployment) - Multi-agent & orchestration approaches - Memory & persistence strategies We also have a **[CROSS-CUTTING.md](CROSS-CUTTING.md)** - a deep horizontal analysis covering: - Architecture pattern taxonomy across all projects - Context management strategies compared - Tool system design patterns - Security posture evaluation - Anti-pattern catalog with evidence - "Build from scratch" recommendations - Safety & security postures - "If I Were Building an Agent Today" synthesis **[Read the full comparison →](COMPARISON.md)** --- ## What Makes This Different | Other "awesome" lists | This repo | |----------------------|-----------| | Curate links and descriptions | **Dissect** repos | | "What they use" | **Why they chose it** | | Overview metrics | **Architecture diagrams + trade-off analysis** | | High-level overviews | **Detailed engineering analysis with code references** | | Praise everything | **Reveal engineering decisions and trade-offs** | --- ## Each Teardown Includes - **Architecture diagrams** - Mermaid + hand-drawn style PNGs showing component relationships - **Detailed analysis** - security posture, architecture trade-offs, code quality observations - **Core innovation analysis** - what the project does that nobody else does - **Code-level references** - file paths + line numbers for every claim - **Cross-project comparison table** - how it stacks up against alternatives - **"Stuff Worth Stealing"** - patterns other projects should adopt - **Verification log** - every factual claim fact-checked against source code - **Easter eggs and hidden details** - the stuff you'd only find reading every file --- ## Knowledge Base Beyond individual teardowns, we maintain cross-cutting analysis: - **[COMPARISON.md](COMPARISON.md)** - Side-by-side comparison across all 16 projects - **[CROSS-CUTTING.md](CROSS-CUTTING.md)** - Patterns, anti-patterns, and architectural trends - **[knowledge/](knowledge/)** - Structured knowledge base: design patterns, anti-patterns, and project metadata --- ## Coming Next - [ ] Crush (22K stars) - OpenCode's successor, built by the Charm team (Bubble Tea) - [ ] Aider (36K stars) - Git-native AI pair programming, Python - [ ] Continue (28K stars) - Open-source AI IDE extension, TypeScript - [ ] Cursor - the most controversial AI IDE (closed source, partial analysis) - [ ] Windsurf - Codeium's AI IDE fork (closed source, partial analysis) Have a project in mind? → [Suggest a teardown](https://github.com/NeuZhou/awesome-ai-anatomy/issues) --- ## Contributing Found an error? Have a better analysis? PRs welcome. - Fix factual errors - Add missing architecture details - Suggest projects to teardown → [Open an Issue](https://github.com/NeuZhou/awesome-ai-anatomy/issues) - Help translate teardowns --- ## Stay Updated New teardown every Tuesday. **[Subscribe to AI Anatomy Newsletter](https://neuzhou.substack.com)** -- the full analysis, delivered to your inbox. Free. **[Follow @Neuzhou_ on X](https://twitter.com/Neuzhou_)** -- teardown highlights + AI agent commentary. Star to bookmark this repo. Watch > Releases to get GitHub notifications when new teardowns drop. 16 deep-dives published so far. The next batch is already in progress. <p align="center"> <a href="https://star-history.com/#NeuZhou/awesome-ai-anatomy&Date"> <img src="https://api.star-history.com/svg?repos=NeuZhou/awesome-ai-anatomy&type=Date" width="600" alt="Star History Chart"> </a> </p> --- ## Legal Notice These teardowns are independent technical commentary for educational purposes under fair use (criticism, commentary, and education). Analysis of proprietary products is based on publicly available information including published npm packages, source maps, and documentation. No source code from analyzed projects is hosted in this repository - only short citations for commentary. Project names and trademarks belong to their respective owners. Star counts and metrics are snapshots at time of writing. Analysis may contain errors - please verify claims against current source code. For takedown requests, please [open an issue](https://github.com/NeuZhou/awesome-ai-anatomy/issues/new) with specific concerns. --- <p align="center"> <i>16 projects dissected. Updated weekly.</i> </p>