00-Home.md

aliases	home index
tags	agentzero developer knowledgebase

🧭 Agent Zero Developer Knowledge Base

A comprehensive reference for operators and developers working with Agent Zero.

---

🚀 Start Here

New to Agent Zero? Read these first:

#	Start With	Why
1	Directory Map	Understand where everything lives — and what gets wiped on update
2	Docker Setup	Get it running with persistent storage
3	Settings	Configure API keys, models, and providers

---

📚 Full Reference

Topic	Description
Agent Loop	How the monologue cycle works
Multi-Agent Hierarchy	Superior/subordinate delegation tree
Project Context	The .a0proj/ project system
WebUI Guide	Web interface, message rendering, plugin UI
Profile Guide	Creating and managing agent profiles
Per-Agent Model Config	Per-profile model overrides
Plugin Architecture	Plugin directory structure and manifest
hooks.py	The hooks.py config hook system
Extension Points	Full catalog of Python + WebUI extension points
Prompt System	Prompt assembly and override mechanism
Memory System	Memory tools and FAISS vector store
Knowledge System	Knowledge files and indexing
Tools Reference	Every tool, its args, and usage
Skills System	Skills workflow packages
Scheduler	Scheduled, planned, and adhoc tasks
MCP Integration	Model Context Protocol tool servers
Common Issues	Symptoms and fixes
Contributing Guide	How to improve this knowledgebase

---

🔍 Codebase Catalogs (Auto-Generated)

Catalog	Content
Prompts	All prompt files in the codebase
API Routes	All API endpoint files
Extension Points (Python)	Python extension point listing
Extension Points (WebUI)	WebUI extension point listing
Tools	Tool file catalog
Skills	Skill directory catalog
Agents	Agent profile catalog

---

Help Resources

• Agent Zero Discord
• Agent Zero Homepage
• Agent Zero DeepWiki
• Agent Zero Docs

Golden Rules

1. Never edit outside /a0/usr/ — anything outside gets blown away on update
2. Plugins rule all — if you need new behaviour, write a plugin
3. Submit PRs to development branch — not main
4. memory_forget is destructive — use sparingly, prefer memory_delete by ID
5. Prompt changes go in usr/agents/ or usr/prompts/ — never edit /a0/prompts/ directly