# A0 Development

Develop or operate Agent Zero: projects, chats, tasks, framework, tools and API/WebUI.

- Repository: https://github.com/agent0ai/agent-zero (19630 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agent0ai/agent-zero --skill a0-development -g -a claude-code -y`
Codex: `npx skills add agent0ai/agent-zero --skill a0-development -g -a codex -y`
Cursor: `npx skills add agent0ai/agent-zero --skill a0-development -g -a cursor -y`
Gemini CLI: `npx skills add agent0ai/agent-zero --skill a0-development -g -a gemini-cli -y`

## Description

Develop or operate Agent Zero: projects, chats, tasks, framework, tools and API/WebUI.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Agent Zero Development

Use this skill to develop Agent Zero or operate an existing instance on the user's behalf. For projects, chats, tasks, and other application features, read `references/operate-agent-zero.md` and use existing APIs. Load only the references needed for the task; verify current source before changing code.

## Reality Rules

1. Source and nearest DOX beat memory, examples, and this skill if they disagree.
2. Before editing, read the applicable `AGENTS.md` chain from the repo root to every file you expect to touch.
3. New capabilities should usually be plugins. For plugin-specific work, load `a0-create-plugin` for authoring/review/contribution or `a0-manage-plugin` for discovery and lifecycle operations.
4. Do not assume ports. Discover WebUI host/port from startup output, launcher or Docker mapping, or explicit `--host`, `--port`, `WEB_UI_HOST`, and `WEB_UI_PORT` configuration.
5. In Docker, framework checks belong to `/opt/venv-a0` and agent/user code execution belongs to `/opt/venv`. Do not use one runtime as proof for the other.
6. Treat `/a0/` as the runtime framework root inside Docker. In local development it means the repository root. If a live container matters, prove that `/a0` matches the checkout before trusting source-only conclusions.
7. Do not document or change ignored `usr/` or `tmp/` runtime state unless the user explicitly asks.

## Reference Map

Load references with:

```json
{"tool_name": "skills_tool:read_file", "tool_args": {"skill_name": "a0-development", "file_path": "references/<file>.md"}}
```

The rest: https://github.com/agent0ai/agent-zero/blob/HEAD/skills/a0-development/SKILL.md