Pots Star

For AI agentsThis page as Markdown/llms.txt

For AI agents: set up pi-durable-bot (Pots).

You install Pots and make the bot. Your person signs in to a model. The bot then connects its own chat apps.

The steps

  1. Warn your person first

    The bot gets full control of the computer it runs on, with no approval step. Recommend a computer or VM of its own; go on only if they agree.

  2. Install where the bot will live

    Node.js 24 or newer, on macOS, Linux or Windows. Over SSH, run it on the server.

    npm install -g pi-durable-bot
  3. See what it can use

    Lists the models and judges ready on this computer, never a secret.

    pots login --list
  4. Ask only what is missing

    Its name, what it is for, how it gets its AI, and who decides on group messages: the bot or Jev.

  5. Your person signs in

    If their choice is not listed, they run this in their own terminal; keys never pass through your chat.

    pots login
  6. Make the bot

    Pick the newest strong model listed and say which. --yes accepts step 1. --judge off if no group chats; --judge typesafe/jev-latest for Jev.

    pots init --yes --name "Ada" --model openai/gpt-6.1-sol --about "our team's research and ops assistant" --no-chat
  7. Check, then hand over

    It must print the bot's answer. Then your person runs pots chat to meet the bot.

    pots chat --bot <id> -m "hi" --timeout 60

Rules

  • Do not create the chat app, collect tokens or edit ~/.pots/ by hand. The bot does that itself.
  • Run pots mcp add only when your person asks for an MCP server.

The full text

for-agents.md on GitHubREADME

Not a bot. A coworker.

Star on GitHub