buddi docs

Every page here describes what buddi does today. The roadmap, ideas and unbuilt specs are kept outside this repository.

Running it

• Install, first run, operations: backup, restore, and where your data lives.
• Provider accounts, Claude subscription sign-in, ChatGPT subscription.

Where you talk to buddi

• The dashboard: the page in your browser, place by place.
• Telegram: pairing, what arrives on your phone, the commands.
• The command line: every buddi command, its flags and exit codes.
• The HTTP API: every route the dashboard uses, and how a script calls buddi without it (an API token).
• Using buddi from Claude Code (buddi mcp).
• Notifications: how buddi reaches you when you are not looking.

What agents do

• Agents: what an agent is, and the catalogue you add more from.
• Conversations: what the model sees, and what you can say while it works.
• Groups, Files, Host execution.
• Computer and browser control, the web plugin.
• Email: accounts, threads, policies, watchers.
• Goals: a target with a clock.
• Learning: buddi proposes, the owner keeps.
• Owner secrets: used, never seen.
• Connections: services that speak MCP, their tools given to your agents.
• The developer plugin: an agent that works in a workspace.
• Speech: agents listen to a recording and answer with a voice.
• Built-in system context.

How it is built

• Architecture: the boundaries, the contracts and the rules the code holds to.

Writing plugins

• Writing a plugin: the guide and the full contract.
• The plugin host API: ctx.buddi, and the boundary.
• Plugin pages: a plugin’s screens, as data.