DotAgents Documentation
DotAgents is a desktop-first agent runtime with mobile control, voice input, file-backed agent configuration, MCP tools, and acpx delegation. These docs are organized around setup paths and operating surfaces, not feature marketing.
Who Are You?
| You want to... | Start with... |
|---|---|
| Install DotAgents and send a first message | Quick Start |
| Download or build the desktop app | Installation |
| Create a specialized agent | Your First Agent |
| Pair the mobile app | Remote Server & Mobile Pairing |
| Connect tools | MCP Tools |
| Connect chat channels | WhatsApp or Discord |
| Understand the file format | The .agents Protocol |
| Contribute to the repo | Development Setup |
Quick Setup
Install from source with the platform script:
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | bash
Windows PowerShell:
irm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex
Then follow Quick Start to configure a provider, run the app, and send a first message.
How DotAgents Is Organized
| Area | What it covers |
|---|---|
| Getting Started | Install, first run, first agent, and setup flow |
| Desktop | Electron app, sessions, panel, remote server, updater, and desktop integrations |
| Mobile | Expo app, QR pairing, voice UX, operations dashboard, and mobile settings |
| Agents | Agent files, roles, skills, knowledge notes, and acpx delegation |
| Tools & Integrations | MCP tools, providers, WhatsApp, Discord, and Langfuse |
| Configuration | Settings, MCP server config, and keyboard shortcuts |
| Security | Local-first data model, pairing, permissions, and privacy |
| Reference | Remote API, headless CLI, diagnostics, and glossary |
| Development | Monorepo map, build/release workflow, architecture, and docs coverage |
Core Concepts
DotAgents has four core pieces:
- Desktop runtime - The Electron app owns local agent sessions, tools, remote server APIs, integrations, and privileged system access.
- Mobile control surface - The mobile app pairs to the desktop remote server for chat, voice, settings, and operations.
- Agent configuration - Agents, skills, tasks, notes, MCP servers, and models live in layered
.agentsfiles. - Tool and delegation layer - MCP connects tools; acpx and ACP-compatible agents handle delegated work.
Important References
- Remote API - Every documented Fastify route used by mobile and external clients
- Build, Release, Deploy - Packaging, signing, docs builds, and deployment flow
- Docs Coverage - The checklist and verifier used to keep docs aligned with source
- Debug & Diagnostics - Logs, diagnostic checks, and troubleshooting commands