Handful docs

How Handful works, page by page. Start with First steps.

• First steps

  Install Handful, start Builder, and see what a bot keeps, how rooms and teams work, and what to know about security.

• Bots and rooms

  Builder, chats, approvals, memory, routines, skills, artifacts and rooms.

• Teams

  How a team takes a task: the lead decides, members do the steps, another member checks, and you approve.

• macOS app

  The Mac app runs the server from login, keeps itself up to date, and can go back to an older version.

• Configuration

  Flags, config.json, the data folder, model and effort, Handful's key, global instructions and phone access.

• Connectors

  Give bots the tools of an external MCP server, such as Slack or a wiki.

• Development

  How to build, check and release Handful, and how it works inside.