sand0vvv/fleet

<p align="center" <img src="assets/logo.svg" width="110" alt="fleet logo" </p

<h1 align="center"fleet</h1

<p align="center" <bA fleet of AI coding agents in your Telegram supergroup.</b<br Self-hosted · local · no account. </p

<p align="center" <a href="https://www.npmjs.com/package/@sand0vvv/fleet"<img src="https://img.shields.io/npm/v/%40sand0vvv%2Ffleet?label=npm&color=22d3ee" alt="npm"</a <a href="LICENSE"<img src="https://img.shields.io/badge/license-MIT-green" alt="MIT"</a <img src="https://img.shields.io/badge/platform-win%20%7C%20mac%20%7C%20linux-8b949e" alt="platforms" </p

---

Fleet lets you drive a whole team of AI coding agents — Claude Code and Codex — from your phone, in a single Telegram supergroup. Each agent gets its own topic in the group. You text (or voice-message) them, they work on your machine and text back: code, files, screenshots, questions, progress.

Everything runs locally. No cloud service, no sign-up, no dashboard. Your Telegram bot token and API keys stay on your machine in ~/.fleet/config.json. Telegram is reached via long-polling — no public URL, no webhook, works behind any NAT.

Built in public and still early — expect rough edges. Issues and PRs welcome.

Quickstart

0. Prerequisites — Node.js ≥ 18 and Claude Code installed and logged in (claude in your PATH). Codex is optional.

1. Make a bot — talk to @BotFather in Telegram: /newbot, pick a name, copy the token.

2. Make the group — create a Telegram group, enable Topics (group settings → Topics), and add your bot as admin (it needs to manage topics).

3. Install & configure:

npm i -g @sand0vvv/fleet
fleet init          # asks for the bot token, voice provider, defaults
fleet doctor        # green lights = ready
fleet start         # the runner — keep this terminal open

4. Link — send /link in your supergroup. The runner binds itself to you (your Telegram user id) and that group. From then on only you can command the fleet.

5. Spawn an agent — in the group's General topic:

/spawn C:\path\to\your\project

A topic appears named after the folder, a terminal window opens on your machine, and the agent is live. Text the topic — the agent answers there. Or from a terminal on the machine: cd into any project and run fleet claude (or fleet codex).