# Threebot

> Open-source app that turns long-lived T3 Code threads into personal agent Bots with a face, memory, routines and a phone-friendly messaging interface.

Threebot is an independent, open-source project that sits on top of T3 Code and turns a long-lived T3 thread into a personal agent called a Bot. Each Bot has its own face, a Markdown memory and a messaging interface that works on a phone. It runs on the user's own machine or server and uses the AI subscriptions or local models already configured in T3 Code.

## What It Is

Threebot is a self-hosted personal-agent layer for T3 Code. A Bot is a normal T3 thread in its own project, so everything it does can still be opened in T3 Code. The user messages the Bot like a person, and the Bot can start and manage other T3 threads and subagents, including on other machines.

The browser app talks to a small Node gateway, which talks to T3 Code. According to the README there is no database: a Bot is a folder holding its config, memory and library, plus a T3 project and thread.

## How Bots Work

- **Creation:** the user picks a face and a name, and Threebot creates the icon and opens the Bot's thread in T3 Code wearing the same face.
- **Routines:** telling a Bot to do something on a schedule, such as every weekday at 8, creates a routine built on T3 scheduled tasks.
- **Memory:** each Bot keeps a Markdown memory file it updates as it learns, plus one memory shared by all Bots. Both can be read and edited in the Memory tab.
- **Bot-to-bot messaging:** Bots can ask each other questions, and the exchange is readable.
- **Independence:** a Bot acts on its own and reports back, stopping to ask only for decisions such as money or identity, and for items on an Always Ask list.
- **Projects board (beta, off by default):** a live board of projects, to-dos, machines, repos, notes and links that Bots can read and edit.

## Apps, Logins and Models

Connected apps such as Gmail, Calendar, Linear, GitHub, Slack, Notion and Stripe run through Executor. A Vault stores encrypted logins that Bots can type into websites without reading the passwords, using T3 Code's secure requests.

Because a Bot is a T3 thread, it runs on whatever T3 Code supports, including Claude, Codex, Cursor, Grok Build, OpenCode, Antigravity, Muse Code, Pi, fx, ACP agents such as Hermes, and local models. The README says it is tested on Claude and Codex, and that Pi and Antigravity need an extra step to load the Bot's MCP tools.

## Setup Path

Threebot requires T3 Code on the same machine with a provider signed in, and Node 22.18 or newer. A one-line installer downloads the latest release, verifies it against SHA-256 sums and installs it in ~/.threebot, and `threebot up` starts it as a background service (launchd on macOS, systemd on Linux) at 127.0.0.1:3780. For phone access, Settings offers Tailscale, a Cloudflare quick link, or a custom domain through Cloudflare Access. Usage stats are off unless turned on.

## Current Status

The README describes the project as early and built around one person's daily use. It needs T3 Code 0.1.6 or later, and because T3's API still changes, breakage after a T3 update is possible. The latest listed release is v0.1.6. Threebot is not affiliated with or endorsed by T3 Tools Inc.

## Features
- Turns a long-lived T3 Code thread into a personal agent Bot
- Installable PWA messaging app for phones with notifications, search and themes
- Per-Bot and shared Markdown memory editable in a Memory tab
- Routines created from natural-language schedules
- Bots start and manage T3 threads and subagents, including on other machines
- Vault of encrypted logins Bots can use without reading passwords
- Connected apps via Executor
- Bot-to-bot messaging
- Customizable Bot faces and avatars
- Projects board (beta)
- Remote access via Tailscale, Cloudflare or custom domain
- Self-update with rollback
- Opt-in anonymous usage stats

## Integrations
T3 Code, Executor, Gmail, Google Calendar, Linear, GitHub, Slack, Notion, Stripe, Claude, Codex, Cursor, Grok Build, OpenCode, Antigravity, Muse Code, Pi, fx, Hermes, Ollama, Tailscale, Cloudflare

## Platforms
MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
0.1.6

## Links
- Website: https://bot.swk.tools
- Documentation: https://github.com/RokaSwK/threebot/tree/main/docs
- Repository: https://github.com/RokaSwK/threebot
- EveryDev.ai: https://www.everydev.ai/tools/threebot
