Skip to main content

​
Introduction

Headmaster is a free, open-source desktop application with built-in AI specialists — a workspace where agents work alongside you on your computer. The agent engine is part of the app itself, so there’s nothing else to download or configure. No terminal tools. No external setup. Drop in an API key and you’re running.

​
Why Headmaster stands out

  • Free & open source — Apache 2.0. Fully open platform.
  • Built-in agent — install and go — works immediately after installation. The agent engine is part of the app, not a separate download.
  • Automated task execution — agents run multi-step tasks, scripts, and tools with your approval. You stay in control.
  • Full file system access — agents read and write files end-to-end. No copy-paste gymnastics.
  • Cross-platform — macOS, Windows, and Linux.

​
What Headmaster does

Headmaster is not a chatbot. It’s a workspace where one or more AI agents do real work on your machine:
  • Write and edit code — the agent reads your repo, writes code, runs tests, and commits.
  • Generate documents — decks, spreadsheets, reports, PDFs. Native file formats, not screenshots.
  • Browse the web — the agent opens pages, reads content, fills forms, and screenshots results.
  • Generate images — text-to-image and image editing inside the chat.
  • Automate tasks — scheduled recurring work, file organization, batch operations.
  • Connect to messaging platforms — reach your agent from Telegram, WeChat Work, DingTalk, Lark, WeCom, iMessage, WhatsApp.
  • Run multiple agents in parallel — the Council mode lets several specialists deliberate on a problem at once.

​
Who Headmaster is for

  • Developers who want an agent that reads their codebase, writes patches, and runs tests — without leaving the desktop.
  • Operators who want to automate recurring work — email triage, report generation, data pipelines — on a schedule.
  • Teams who want a shared AI workspace with persistent memory, approval gates, and audit trails.
  • Power users who already live in a CLI agent (Claude Code, Codex, Gemini CLI, and others) and want a unified desktop interface for all of them.

​
What Headmaster is not

  • Not a cloud SaaS. Your data lives on your machine. The runtime is a local process.
  • Not a model provider. Headmaster connects to providers you already have keys for (Anthropic, OpenAI, Google, OpenRouter, and 300+ others).
  • Not a thin chat wrapper. The agent engine is built in — file operations, tool calls, MCP connections, scheduling, and multi-agent orchestration are all part of the app.