butterfly-bot 0.8.0

Butterfly Bot

Butterfly Bot is an opinionated personal-ops AI assistant built for people who want results, not setup overhead.

It is built to be Zapier-first: most real-world integrations run through Zapier MCP, so the fastest path is simply adding your Zapier MCP token in the Config screen.

Get your Zapier key here: https://zapier.com/mcp and setup your integrations there.

Install

Ubuntu

Download the deb file for Ubuntu from the latest GitHub Release

Mac

Download the app file for Mac from the latest GitHub Release

Why users pick it:

Fast value: works out-of-the-box with default settings.
OpenAI-first: optimized for OpenAI routing and coding with simple key-based setup.
UI-first: polished desktop app with collaboration-first workflow tabs for execution, planning, and chat.
Automation: full toolset provided for your always-on agent.
Integrations: Zapier-first MCP integration model for connecting your existing SaaS stack in minutes.
Security: WASM-only execution for tools plus OS keychain-backed secrets - no plaintext secrets or insecure tools.
Memory: best-in-class memory that remembers the facts and when they happened.

OpenAI setup (recommended)

Open the app and go to Config.
Paste your OpenAI API key.
Save the config and start chatting.

Notes:

Router model defaults to gpt-4.1-mini on api.openai.com.
Memory models run on OpenAI defaults.
Grok API key is optional and only used for internet search.

Zapier-first setup (60 seconds)

If you only configure one thing, configure Zapier:

Open the app and go to Config.
Paste your Zapier MCP token and save the config.

That single token unlocks most production workflows because Butterfly Bot can route actions through Zapier's connected apps (email, calendar, tasks, CRM, docs, alerts, and more).

Want a fast start? Use the ready-made templates in examples/ and paste a context.md + heartbeat.md pair into the app.

Human ↔ Agent collaboration tabs

Butterfly Bot now separates conversation from execution so humans and agents can coordinate in one shared workflow surface:

Inbox - actionable items and ownership handoffs.
Kanban - stage-based workflow overview.
Dependencies - blocker and prerequisite visibility.
Gantt - estimate-based timeline visualization.
Audit - authoritative lifecycle and state-transition ledger.
Chat - human ↔ agent conversation only.
Activity - operational/system timeline updates.
Config / Diagnostics / Context / Heartbeat - setup, runtime health, and agent behavior controls.

This keeps work artifacts, operational evidence, and chat clearly separated while still connected through shared item references and lifecycle state.

Built for the money layer: Agentic Wallet + x402 Payments

Butterfly Bot is built around a first-of-its-kind hardware-encrypted agentic wallet so your AI can act, pay, and execute with strong built-in protection.

What this means for non-technical users:

Your wallet is protected by hardware-grade encryption by default.
Your assistant can run agentic payments with x402 for real autonomous commerce flows.
You stay in control with approval checkpoints for sensitive actions.

Simple story: your assistant is not just smart - it can also be an economic actor.

Read the deeper details: docs/solana-x402-economic-actor.md

Documentation map

I need…	Go here
Product and architecture deep dive	docs/product-deep-dive.md
Security audit behavior and guidance	docs/security-audit.md
Threat model and trust boundaries	docs/threat-model.md
TPM/custody hardening plan	docs/tpm-cocoon-security-plan.md
Cross-platform reliability plan	docs/everyone-plan.md
Coverage to 100% plan	docs/coverage-100-plan.md
Daily blackbox report template	docs/blackbox-daily-report-template.md
Security evidence requirements	docs/security-evidence-manifest.md