DotAgents Documentation
One dot. Every agent. Your assistant. Your machine. Your rules.
Welcome to the DotAgents documentation. DotAgents is a voice-first AI agent orchestrator that gives you a team of AI specialists — each with memory, skills, and tools — controlled by your voice.
Built on the .agents open standard, your skills work across Claude Code, Cursor, Codex, and every tool adopting the protocol.
Quick Navigation
Get Started
- Installation — Download and install DotAgents on macOS, Windows, or Linux
- Quick Start — Up and running in under 5 minutes
- Your First Agent — Create and configure your first AI agent
Core Concepts
- Architecture Overview — How DotAgents is built and how the pieces fit together
- The .agents Protocol — The open standard for agent configuration
- Protocol Ecosystem — MCP, ACP, Skills, and how they interoperate
Platform Guides
- Desktop App — The full-featured Electron desktop experience
- Mobile App — AI agents on iOS, Android, and the web
- Voice Interface — Hold to speak, release to act
Agent System
- Agent Profiles — Specialized AI personas with distinct skills and tools
- Skills — Portable, reusable agent capabilities
- Memory — Persistent context across sessions
- Multi-Agent Delegation (ACP) — Agents delegating tasks to other agents
Tools & Integrations
- MCP Tools — Connect to any tool via the Model Context Protocol
- WhatsApp Integration — Send and receive messages through WhatsApp
- Observability (Langfuse) — Monitor, trace, and debug your agents
- AI Providers — Configure OpenAI, Groq, Google Gemini, and local models
Configuration
- Settings Reference — All configurable options in one place
- MCP Server Configuration — Add and manage tool servers
- Keyboard Shortcuts — Every hotkey and shortcut
Security & Privacy
- Security Model — How DotAgents protects your data
- Privacy Policy — Zero data collection, local-first design
Development
- Development Setup — Clone, build, and run from source
- Architecture Deep Dive — Technical architecture for contributors
- Contributing — How to contribute to DotAgents
Reference
- Remote API — HTTP API for mobile and external clients
- CLI & Debug Flags — Debug logging and diagnostic tools
- Glossary — Key terms and definitions
What is DotAgents?
DotAgents is three things:
1. An App — A voice-first AI agent interface. Hold to speak, release to act. Your agents listen, think, and execute tools on your behalf. Available on desktop (macOS, Windows, Linux) and mobile (iOS, Android).
2. The .agents Protocol — An open standard for agent skills, memories, and commands. Define your skills once in .agents/, and they work across Claude Code, Cursor, OpenCode, and any tool that adopts the protocol.
3. Agent Skills — Reusable capabilities your agents can learn. Skills are portable, shareable, and composable — not locked into any single tool or vendor.
Community & Support
- Discord — Join the DotAgents community
- GitHub — Source code, issues, and releases
- Website — dotagents.app
License
DotAgents is open source under the AGPL-3.0 License.