# botdot

> A self-hosted team of Claude Code bots you run by chat. Each bot is a Claude Code agent with one job and its own tools, permissions, workspace and schedule. The owner tells the Chief of Staff what they need in a chat; it makes the bots, runs them and reports back, and anything risky waits for the owner's OK in Needs you. It runs on the owner's own Linux server (each account walled off under rootless Docker and gVisor) and is used from the web page, the Android app and the desktop app for Windows, Mac and Linux. It uses the official Claude Code CLI with the owner's own Claude subscription or API key. MIT licensed, no telemetry.

Install on a fresh Linux server or VM (not a container) as a user with sudo:

```sh
curl -fsSL https://raw.githubusercontent.com/Kordal/bot-dot/main/get.sh | sudo sh
```

Or by hand:

```sh
git clone https://github.com/Kordal/bot-dot.git bot-dot-source
sudo sh bot-dot-source/install.sh
```

It needs at least 4 CPUs, 8 GB of RAM and 40 GB of free disk; Ubuntu 22.04 or newer, Debian 12 or 13, Fedora, or RHEL 9 or 10 and its rebuilds; a Claude Pro, Max or Ultra subscription or an Anthropic API key; and a domain pointed at the server or a Tailscale tailnet.

## Docs

- [README](https://raw.githubusercontent.com/Kordal/bot-dot/main/README.md): what botdot is, quickstart, requirements, features, security
- [Install on Linux](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/install-linux.md): requirements, accounts, updates, backups, uninstall, platforms
- [The desktop app](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/desktop.md): downloads for Windows, Mac and Linux, and botdot on your own computer
- [User guide](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/user-guide.md): the app and every feature
- [FAQ](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/FAQ.md): requirements, costs, updates, privacy, troubleshooting
- [What bots can reach](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/what-bots-can-reach.md): what each bot, the Chief of Staff and botdot may see
- [Security](https://raw.githubusercontent.com/Kordal/bot-dot/main/SECURITY.md): what botdot protects and how to report a problem

## For developers and agents

- [The API](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/api.md): the contract between the botdot server and its apps
- [Vocabulary](https://raw.githubusercontent.com/Kordal/bot-dot/main/CONTEXT.md): the product's words (bot, Chief of Staff, Board, Needs you)
- [AGENTS.md](https://raw.githubusercontent.com/Kordal/bot-dot/main/AGENTS.md): how work is done in the repository
- [Development](https://raw.githubusercontent.com/Kordal/bot-dot/main/docs/development.md): running from source, tests, code layout

## Optional

- [Changelog](https://botdot.app/changelog.md): what changed, day by day
- [Source code](https://github.com/Kordal/bot-dot)
- [Releases](https://github.com/Kordal/bot-dot/releases): the desktop app and the Android app