Skip to main content
DotAgents Documentation

Run agents from your desktop, phone, and chat tools.

DotAgents is a desktop-first agent runtime with mobile control, voice input, file-backed agent config, MCP tools, and acpx delegation. These docs are organized around the jobs operators actually need to finish.

Start quick setupDownload release
InstallFull guide
macOS / Linuxcurl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | bash
Windows PowerShellirm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex
Runtime
Electron desktop app with local agent services
Mobile
Expo client paired through the desktop remote server
Config
Layered global and workspace .agents files
Start here

Choose the path that matches what you are trying to do.

New to DotAgents

Start with the guided setup, install the desktop app, and send the first message.

Ready to install

Use the release downloads or one-line scripts for macOS, Windows, and Linux.

Pairing mobile

Enable the desktop remote server, scan the QR code, and connect the mobile app.

Configuring agents

Define agent files, tools, skills, model overrides, and delegation targets.

Adding integrations

Connect MCP servers, WhatsApp, Discord, providers, and observability.

Contributing

Build the monorepo, run checks, and understand desktop/mobile boundaries.

Quick setup

A practical first run in four steps.

01

Install DotAgents

curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | bash

Install from source or download a signed release build.

02

Run setup

Choose providers, configure the desktop runtime, and verify the app can talk to an agent.

03

Create an agent

Give it a system prompt, tools, skills, and optional model overrides.

04

Connect tools and surfaces

Add MCP servers, pair mobile, and route trusted WhatsApp or Discord messages.