# mainplane (mainplane-ai/mainplane)

> Mainplane is an open-source agent harness: a self-hosted ecosystem for running AI agents that connect to your models, your devices and your messaging channels.

- GitHub: https://github.com/mainplane-ai/mainplane
- GitHub.Locker page: https://github.locker/mainplane-ai/mainplane
- Stars: 679
- Language: Go
- License: MIT
- Last push: 2026-11-02

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a library I import, or something I run?**

You run it. It is a self-hosted server you start with a single command, and then you add providers, workers and connectors through the quickstart.

**How do I get it running?**

Run the quickstart command on an always-on machine. It walks you through adding a model provider, workers (computers your agents control) and connectors (ways to message your agents). The full guide is in docs/self-hosting.md.

**Do I need an API key or a subscription?**

Not strictly. You can use an API key with any model, or connect your regular Claude Code or ChatGPT Codex subscription to use its standard limits.

**Does the server need Linux?**

No, mainplane-server runs on macOS, Windows and Linux. However, hosting shared file drives requires a compatible connected Linux device.

**Does Mainplane share my data?**

Your chats are not shared by default. You can opt in to sharing data to help improve Mainplane in /settings.

**Do I need Tailscale to connect my devices?**

No. Mainplane links agents and computers with fine-grained security controls, so no Tailscale is needed.

**Can the agents use my real browser and apps?**

Yes. Mainplane drives your real browsers and applications with native computer use.

**What is the shared file drive feature?**

It sets up a remote filesystem you can use concurrently without risk of de-sync between agents and devices.


---

## README (checked against GitHub 2026-11-03)

Source: https://github.com/mainplane-ai/mainplane/blob/main/README.md

<picture>
  <source media="(max-width: 700px), (hover: none) and (pointer: coarse)" srcset="https://raw.githubusercontent.com/mainplane-ai/github-media/main/hero-mobile-v2.svg">
  <img src="https://raw.githubusercontent.com/mainplane-ai/github-media/main/hero-desktop-320-v2.svg" alt="Mainplane, with the biplane flying over the clouds" width="960">
</picture>
<div><h3>Mainplane is an open-source agent harness</h3></div>
<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mainplane-ai/github-media/main/tui-dark.svg">
  <img src="https://raw.githubusercontent.com/mainplane-ai/github-media/main/tui-light.svg" alt="The Mainplane TUI: a sidebar of sessions on different models, and an agent that moves a Qwen fine-tune from a GPU server to a Mac Studio and quantizes it to run there" width="960">
</picture>

# Self-Hosting Quickstart

Run this command on your server machine (any always-on machine will do):

```shell
# Linux, macOS
curl -fsSL https://mainplane.ai/install | sh -s -- server quickstart

# Windows
& ([scriptblock]::Create((irm https://mainplane.ai/install.ps1))) server quickstart
```

The quickstart walks you through adding a provider, workers (computers your agents control) and connectors (ways to message your agents).

Read more in [docs/self-hosting.md](docs/self-hosting.md), and [docs/privacy-and-security.md](docs/privacy-and-security.md).

<br><br>

# Features
### Model agnostic
- Mainplane can use any model from any provider, including Anthropic, OpenAI, Google, and more.

### Context efficient
- Mainplane agents have a restricted set of tools and manage their own context by retrieving key information from other sessions.

### Connects all your devices
<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mainplane-ai/github-media/main/architecture-3d-dark.svg">
  <img src="https://raw.githubusercontent.com/mainplane-ai/github-media/main/architecture-3d-light.svg" alt="The Mainplane Architecture: connectors reach Mainplane Server, which holds secrets and controls, observability and the file server; the network joins the server and every worker" width="960">
</picture>

- Mainplane links agents and computers with fine-grained security controls. No Tailscale needed.

### Shared file drives
- Mainplane sets up a remote filesystem you can use concurrently without risk of de-sync.

### Browser and computer use
- Mainplane drives your real browsers and applications with native computer use.

# FAQ
<details>
<summary>Can I bring my Claude Code or ChatGPT subscription?</summary>

Yes, Mainplane can use the regular limits of a Claude Code or ChatGPT Codex subscription, or an API key with any model.
</details>

<details>
<summary>Does Mainplane share my data?</summary>

Your chats are not shared by default. Users can opt in to sharing data to improve Mainplane in /settings.
</details>

<details>
<summary>Do I need more than one device?</summary>

No. Everything can run on one device.
</details>

<details>
<summary>Does mainplane-server need Linux?</summary>

No. mainplane-server runs on macOS, Windows and Linux. Hosting shared files requires a compatible connected Linux device.
</details>

<details>
<summary>Do you take contributions?</summary>

We welcome feedback as GitHub issues. Pull requests are open to collaborators only. Any agent can POST plain text to https://bugs.mainplane.ai to report a bug.
</details>

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mainplane-ai/github-media/main/footer-still-dark.svg">
  <img src="https://raw.githubusercontent.com/mainplane-ai/github-media/main/footer-still-light.svg" alt="A billboard turns through what Mainplane agents do, while the biplane tows a banner: Now you're flying!" width="960">
</picture>