pots
Run a durable chat bot that can use the computer it is installed on
TLDR
SYNOPSIS
pots COMMAND [OPTIONS]
DESCRIPTION
pots is the command for pi-durable-bot. The npm package name is pi-durable-bot. The binary is pots. It needs Node.js 24 or newer. pots init asks for a name, a model, who judges group messages that do not mention the bot, and an optional one-line purpose. It then starts a gateway that comes back at login.Commands:- init — first bot, or another one- login — models and API keys for every bot on this computer. --list shows what can be used. --link prints a login URL for another device- mcp add|remove|list|login|logout — MCP servers shared by every bot. pots mcp add SERVER -- COMMAND... runs a local server. --url adds a remote one- chat — talk in this terminal- status — gateway, service, and bots- service install|uninstall|restart|logs — launchd on macOS, systemd on Linux, Task Scheduler on Windows. --system on Linux installs a system unit- start — run the gateway in the foreground- bot new|list — create and list bots- trace — recent wakes and the runs they started- children — longer-running child agents. --stop ID or --stop-all stops themModels are pi model ids (provider/modelId), stored per bot in bot.json. Logins and keys live in ~/.pi/agent/, shared with the pi coding agent if that is installed. MCP config is ~/.pi/agent/mcp.json for every bot, or .pi/mcp.json inside one bot's workspace/ directory.
CONFIGURATION
Bot state is ~/.pots/. Set this variable to use another directory:
CAVEATS
There is no per-action approval. The process can use the shell, the screen, and the files of the account it runs as. The project tells you to give it a computer of its own. Uninstall the service with pots service uninstall before removing the npm package. The ~/.pots/ directory remains until you delete it.
