Agent Zero is a dynamic, organic agentic framework for running AI agents that can create tools, write code, browse the web, cooperate with other agents, and keep learning from your goals and projects.
Introduction | Space Agent | Quick Start | LLM Plans | CLI Connector | Features | Examples | Docs
Agent Zero is not a predefined one-purpose agent.
It is a transparent, extensible framework where the agent can use the operating system as a tool: a real Linux environment, terminal, code execution, files, memory, browser automation, plugins, and tools it learns to create along the way.
The goal is simple: give an AI agent enough environment, memory, communication, and freedom to solve real tasks while keeping the work inspectable and steerable by you.
curl -fsSL https://bash.agent-zero.ai | bashirm https://ps.agent-zero.ai | iexdocker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zeroThen open the Web UI, configure your LLM provider, and start with a concrete task. For the full setup path, including updates and platform notes, see the Installation guide.
Agent Zero can use a Kali Linux system to accomplish your task. It can inspect files, run commands, write code, install and use tools, create scripts, search the web, and adapt its workflow as the task evolves.
The important idea is not a fixed list of buttons. The important idea is that the agent can build and use the right tool when the work demands it.
Agent Zero is becoming more visual and collaborative. The right-side Universal Canvas gives agents and humans shared working surfaces for browser sessions, Office files, workspace history, and other plugin panels.
The canvas makes agent work visible. You can watch it browse, inspect what changed, open files, cowork on deliverables, and intervene before a small mistake becomes a large one.
Create, open, and cowork with the AI on documents, spreadsheets, and presentation decks.
The Office canvas supports editable artifacts with Collabora Online and WOPI, including DOCX, XLSX, and PPTX workflows. Agents can create substantial deliverables, read their contents, apply precise saved edits, preserve version history, and generate native XLSX charts directly inside spreadsheets.
Agent Zero includes a direct Playwright-powered Browser tool with a visible WebUI viewer. The agent can navigate pages, inspect readable page content, and act through typed page references such as [link 3], [button 6], and [input text 8].
For web and mobile development, Annotate mode lets you click page elements or regions and leave actionable comments for the agent targeted at the page itself. You can review a UI visually, mark what needs to change, and send those notes straight back into the conversation.
The Browser also supports Chrome extensions installed from the Chrome Web Store directly inside the Agent Zero browser environment, so workflows can use the same kind of browser capabilities real users depend on.
Agent Zero can now connect to your OpenAI Codex plan through the new OAuth flow. Sign in with your account, pick the Codex-backed provider, and let Agent Zero use the plan you already have.
Click "Connect", enter the device code in the OpenAI page. Choose your model after checking the list, and you're all set.
This is the first step toward account-backed LLM plans in Agent Zero. More integrations are coming, including Gemini CLI, Claude Code based on extra-usage, and more.
Agent Zero is safe when it lives in Docker. The A0 CLI Connector is how you intentionally let it work beyond the container: on your host machine, in a terminal-first workflow, or against a server where you do not want a GUI at all.
Install the connector on the machine you want Agent Zero to work on, not inside the Agent Zero container.
curl -LsSf https://cli.agent-zero.ai/install.sh | shirm https://cli.agent-zero.ai/install.ps1 | iexThen run:
a0a0 connects your terminal to an Agent Zero instance. It can usually discover a local instance automatically, or you can point it at a remote Agent Zero URL hosted somewhere else, such as a VPS or tunnel.
When you activate Read+Write access and the Remote Code Execution Tool in the CLI, Agent Zero can operate on the filesystem and shell of the machine where a0 is running. That means it can work on your real local project files, not only files inside the Docker sandbox.
This is especially useful if you:
- prefer CLI workflows;
- want Agent Zero to work in an existing local repository;
- are running Agent Zero on a remote server;
- need code execution on a headless machine without using the Web UI;
- want Docker isolation for Agent Zero while still granting explicit, controlled access to selected host-side work.
For full setup details, manual fallback installation, and remote-host tips, see the A0 CLI Connector guide.
Projects isolate workspaces, instructions, memory, secrets, knowledge, repositories, and model presets. Clone a public or private Git repo into an isolated project and give the agent context that belongs to that work alone.
Skills use the open SKILL.md standard: portable, structured capabilities that can be activated globally, per project, or for the current chat. Agent Profiles let you switch the behavior, prompt overrides, tools, extensions, and model configuration of the active agent without rewriting the whole system.
Every agent can create subordinate agents to break down work. The superior gives tasks and receives reports; subagents keep their own contexts focused and return their findings when done.
This makes Agent Zero useful for research, software engineering, data analysis, plugin development, and tasks where several specialized perspectives are better than one overloaded context.
Almost nothing is hidden. Prompts live in prompts/, tools live in tools/ or plugins, and built-in behavior can be inspected, changed, replaced, or extended.
Agent Zero supports plugins, MCP, A2A, custom tools, custom prompts, project-scoped configuration, environment-based deployment settings, and a Web UI designed to keep the agent's work readable in real time.
- Fully Dockerized runtime with a clean Web UI.
- Real-time streamed output so you can interrupt, redirect, or refine the work as it happens.
- Speech-to-text and text-to-speech support.
- Chat load/save, generated HTML logs, file browser, settings UI, and deployment-friendly
A0_SET_configuration.
- Research with a browser: "Open the browser, compare three project management tools for a small AI team, and summarize the tradeoffs with source links."
- Cowork on a spreadsheet: "Create an editable XLSX budget model with assumptions, monthly projections, and a native chart."
- Review a web UI: "Open my local app in the Browser. I will annotate the page with comments; then implement the requested UI fixes."
- Work inside a Git project: "Clone this repository into a new project, inspect the architecture, and propose the safest first improvement."
- Create a specialist: "Create an Agent Profile for financial analysis with cautious reasoning, clear assumptions, and spreadsheet-first deliverables."
- Recover a workspace: "Show me recent Time Travel snapshots and explain what changed before I revert anything."
Agent Zero is the open framework and Linux-powered agent workbench.
Space Agent is our newer product direction for the agent-shaped workspace: a Space the agent can reshape from inside your browser, with live demos, a desktop app, and a path to running a real server for yourself or your team.
If you want the raw power and deep customizability of an agent with a full Linux system, start here with Agent Zero. If you want the polished Space experience for easier personal, team, desktop, or self-hosted use, explore Space Agent.
Time Travel gives Agent Zero-owned /a0/usr workspaces snapshot history, diff inspection, travel, and revert. It is designed for recoverable agent work: see what changed, compare files, inspect a past state, and roll back when needed. Try it in Space Agent as well (link above).
It is not a replacement for Git or backups. It is a practical safety layer for the workspace where agents are actively creating and editing files.
- Software engineering: inspect a codebase, make scoped edits, run tests, explain tradeoffs, and keep a recoverable history of file changes.
- Host-machine development: connect with
a0, grant Read+Write and remote execution when needed, and let Agent Zero work in your real local repositories. - Financial analysis and charting: collect data, correlate events, create spreadsheets, and generate editable charts.
- Office deliverables: cowork on documents, spreadsheets, and presentation decks instead of trapping the result in chat text.
- Web and mobile QA: browse an app, annotate UI issues, install browser extensions, and turn visual comments into actionable fixes.
- API integration: paste an API snippet, let the agent build a working example, and store the pattern for future use.
- Client/project isolation: keep memory, secrets, instructions, files, and model choices separated by project.
- Scheduled operations: run recurring checks and monitoring tasks with project-scoped context and credentials.
Agent Zero is powerful because it can use a real environment. Treat it with the same respect you would give a capable developer with shell access.
- Keep it running inside Docker or another isolated environment.
- Do not mount your entire home directory unless you understand the risk.
- Grant A0 CLI Read+Write access and remote code execution only for machines and workspaces you trust.
- Store credentials in project secrets or settings, not in prompts or public files.
- Review actions that touch accounts, money, production systems, or private data.
- Keep backups for important workspaces.
- Install browser extensions and third-party plugins only from sources you trust.
| I want to... | Start here |
|---|---|
| Install or update Agent Zero | Installation |
| Learn the UI and basic workflow | Quickstart |
| Connect Agent Zero to host-machine files and shell | A0 CLI Connector |
| Use projects and Git workspaces | Projects guide |
| Create or switch Agent Profiles | Agent Profiles |
| Use skills and agent capabilities | Usage guide |
| Configure MCP or external tools | MCP setup |
| Understand the architecture | Architecture |
| Build extensions or plugins | Extensions |
| Contribute to the project | Contributing |
| Troubleshoot problems | Troubleshooting |
Agent Zero is built for people who want to understand and shape their tools.
You can help by improving docs, creating skills, publishing plugins, testing model/provider setups, reporting bugs, sharing workflows, or contributing core improvements. Start with the Contributing guide, browse the Plugin Hub, or bring ideas to Discord.
- Discord for live discussion and help.
- Skool Community for community learning.
- YouTube for demos and tutorials.
- X, LinkedIn, and Warpcast for updates.
- GitHub Issues for bugs and feature requests.