Headmaster Documentation
Everything you need to install, configure, and master Headmaster Desktop. From your first conversation to multi-agent automation.
Getting Started
Core Concepts
Memory
What the agent remembers across sessions
Session search
Full-text search across all past conversations
Modes
Work Along, Run It Yourself, Hands-Off, Autopilot
The Council
Multi-perspective deliberation with parallel specialists
Specialists
The 20+ built-in assistants and custom hires
Skills & The Agency
Install community skills, write your own
Your Crew
Connect external CLI agents — Claude Code, Codex, 15+ more
Profiles
Multiple independent agent configurations
Personality & voice
Define the agent's personality and context files
Configuration
Settings overview
Every tab in Settings
Connections (MCP)
MCP servers — 4 transport types, JSON, CLI import
Integrations
External services the agent can reach
Channels
Telegram, WeChat Work, DingTalk, Lark, WeCom, iMessage, WhatsApp
Runtime settings
Local vs remote, restart, sessions, schema config
Headmaster on the Go
Browser WebUI — LAN, Tailscale, server, mobile
The Schedule
Cron scheduling, keep-awake, catch up, delivery
Appearance & themes
Themes, custom CSS, fonts, colors, density
Features
Tools & toolsets
60+ tools — web, terminal, browser, media, code, delegation
Terminal backends
6 backends — local, Docker, SSH, Singularity, Modal, Daytona
File management
Auto-organize, batch rename, file operations
Preview panel
Multi-format viewer — markdown, code, HTML, PDF, Office, diffs
Documents
Generate Decks, Spreadsheets, Reports, PDFs locally
Image generation
Gemini, OpenRouter, OpenAI, Stability, and more
Voice mode
Real-time voice — STT, TTS, push to talk, continuous
Browser
Web automation — navigate, read, fill forms, screenshot
Kanban
Visual task board — cards, columns, agent progress
Subagent delegation
Spawn isolated subagents for parallel work
Activity & Deliverables
Audit trail of agent actions and files produced
Approvals & human-in-the-loop
Approval gates, clarifications, permissions, audit
Security
Container isolation, secret blocking, access control
Reference
Troubleshooting
Fixes for runtime issues, 401s, crashes, updates
Updating Headmaster
Stable vs prerelease, rollback, offline updates
Data, privacy & security
What's local, what's sent, encryption, uninstall
Use cases & user stories
Real-world examples across 12 categories
FAQ
Frequently asked questions
Keyboard shortcuts
Every shortcut in the desktop app
Glossary
Headmaster vocabulary explained