-
-
-
-[Development Setup](./docs/setup/dev-setup.md) • -[Usage](./docs/guides/usage.md) - -Or see DeepWiki generated documentation: +[Introduction](#what-agent-zero-is) | +[Space Agent](#agent-zero-and-space-agent) | +[Quick Start](#quick-start) | +[CLI Connector](#a0-cli-connector-use-agent-zero-on-your-host-machine) | +[Features](#what-makes-agent-zero-different) | +[Examples](#try-these-first) | +[Docs](#documentation) [](https://deepwiki.com/agent0ai/agent-zero) +[Ask ChatGPT](https://chatgpt.com/?q=Analyze%20this%3A%20https%3A%2F%2Fgithub.com%2Fagent0ai%2Fagent-zero) | +[Ask Claude](https://claude.ai/new?q=Analyze%20this%3A%20https%3A%2F%2Fgithub.com%2Fagent0ai%2Fagent-zero) +
+
+
+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.
+
+## Real-World Use Cases
+
+- **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.
+
+## Safety Model
+
+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.
+
+## Documentation
+
+| I want to... | Start here |
+| --- | --- |
+| Install or update Agent Zero | [Installation](./docs/setup/installation.md) |
+| Learn the UI and basic workflow | [Quickstart](./docs/quickstart.md) |
+| Connect Agent Zero to host-machine files and shell | [A0 CLI Connector](./docs/guides/a0-cli-connector.md) |
+| Use projects and Git workspaces | [Projects guide](./docs/guides/projects.md) |
+| Create or switch Agent Profiles | [Agent Profiles](./docs/guides/agent-profiles.md) |
+| Use skills and agent capabilities | [Usage guide](./docs/guides/usage.md) |
+| Configure MCP or external tools | [MCP setup](./docs/guides/mcp-setup.md) |
+| Understand the architecture | [Architecture](./docs/developer/architecture.md) |
+| Build extensions or plugins | [Extensions](./docs/developer/extensions.md) |
+| Contribute to the project | [Contributing](./docs/guides/contribution.md) |
+| Troubleshoot problems | [Troubleshooting](./docs/guides/troubleshooting.md) |
+
+## Build With Us
+
+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](./docs/guides/contribution.md), browse the [Plugin Hub](./docs/guides/usage.md), or bring ideas to Discord.
+
+## Community and Support
+
+- [Discord](https://discord.gg/B8KZKNsPpj) for live discussion and help.
+- [Skool Community](https://www.skool.com/agent-zero) for community learning.
+- [YouTube](https://www.youtube.com/@AgentZeroFW) for demos and tutorials.
+- [X](https://x.com/Agent0ai), [LinkedIn](https://www.linkedin.com/company/109758317), and [Warpcast](https://warpcast.com/agent-zero) for updates.
+- [GitHub Issues](https://github.com/agent0ai/agent-zero/issues) for bugs and feature requests.
diff --git a/docs/res/a0-vector-graphics/horizontal_banner.svg b/docs/res/a0-vector-graphics/horizontal_banner.svg
new file mode 100644
index 000000000..ddf5a215f
--- /dev/null
+++ b/docs/res/a0-vector-graphics/horizontal_banner.svg
@@ -0,0 +1,60 @@
+
\ No newline at end of file
diff --git a/docs/res/showcase-thumb.png b/docs/res/showcase-thumb.png
deleted file mode 100644
index c2cb31020cc4dca06709d3d430d9611cc6da5ee8..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 21896
zcmeFYg