# BWOC Framework — Buddhist Way of Coding > BWOC is an open-source (MIT), Rust-native, local-first framework for building AI coding agents on principled foundations. One `AGENTS.md` is the single source of truth for 21 declared backends; agents get persistent memory, git-worktree isolation, a sandboxed run loop, and signed inter-agent messaging. Buddhist frameworks are used as engineering thinking aids, not religious doctrine. Current software version: 3.17.0. License: MIT. Bilingual docs: English and Thai. ## Start here - [Website](https://bwoc.bemind.tech/): overview, the 22 frameworks, platform, install - [GitHub repository](https://github.com/bemindlabs/bwoc-framework): source, releases, issues - [README](https://github.com/bemindlabs/bwoc-framework/blob/main/README.md): install, quick start, crates, architecture - [Philosophy](https://github.com/bemindlabs/bwoc-framework/blob/main/modules/agent-template/docs/en/PHILOSOPHY.en.md): the 22 frameworks and how each maps to an engineering problem - [Vision](https://github.com/bemindlabs/bwoc-framework/blob/main/VISION.md) ## Install - Homebrew (macOS, Linux): `brew tap bemindlabs/bwoc https://github.com/bemindlabs/bwoc-framework`, then `brew trust bemindlabs/bwoc`, then `brew install bwoc` - Quick start in any repo: `bwoc auth set anthropic` then `bwoc` ## Key facts - Backends: Claude, Antigravity, Codex, Kimi, Copilot, Grok, Ollama, OpenAI-compatible, OpenRouter, LiteLLM, plus pi, omp, Devin, Droid, OpenCode, Kilo, Hermes, Qoder, Qwen, Cursor, Mastra Code - Workspace crates: bwoc-core, bwoc-cli, bwoc-agent, bwoc-harness, bwoc-tui, bwoc-loop-tui, bwoc-signing, bwoc-a2a, bwoc-connect, bwoc-mqtt, bwoc-deep-memory - Safety: on Linux, Landlock/seccomp confine the harness run loop; capability gate, ed25519-signed envelopes verified before delivery (tampered or unsigned refused); since 3.17 a sender missing the recipient's required trust qualities is refused by default (BWOC_TRUST_GATING=warn keeps warn-only) - TUI: bare `bwoc` opens a ratatui chat on bwoc-harness; /agents opens other agents in side panes; /undo and /redo for agent file edits; permission modes default, accept_edits, bypass, plan - Harness: self-hosted run loop (Ollama, OpenAI-compatible, OpenRouter, LiteLLM) with capability gate, guardrails, permission policy, OS sandbox, MCP client, checkpoint/resume, OpenTelemetry - Loop engineering: Goal + Ticker + Gate; `bwoc loop` control center; shipped today is the goal loop over a team lead (re-fire on task-list change, DoD = all tasks Completed, budget-bounded); cron and adaptive tickers are planned - Fleet panes: `bwoc fleet term` opens one terminal pane per agent (layouts grid, columns, rows, main-vertical, main-horizontal) in tmux (default) or herdr (`--backend herdr` or `[fleet] pane_backend = "herdr"`); with `[integrations.herdr] enabled = true`, `bwoc sessions` shows agents blocked on you or done; herdr is optional and pre-1.0 - Memory: file-based index capped at 200 lines; stale entries are pruned by design ## Ecosystem (public repositories, github.com/bemindlabs/bwoc-*) - [bwoc-framework](https://github.com/bemindlabs/bwoc-framework): The framework itself: agent template, bwoc CLI, daemon, harness, signing, A2A and deep memory. - [bwoc-handbook](https://github.com/bemindlabs/bwoc-handbook): Bilingual EN/TH handbook indexed by role: end user, developer, agent author, AI search. - [bwoc-agent-installer](https://github.com/bemindlabs/bwoc-agent-installer): Installer and guided TUI setup wizard (bwoc-setup) for people who do not code. - [bwoc-mcp](https://github.com/bemindlabs/bwoc-mcp): MCP server that exposes a BWOC workspace (agents, teams, tasks, memory, run/send/fleet) to any MCP client. - [bwoc-gateway](https://github.com/bemindlabs/bwoc-gateway): Rendezvous and relay server for multi-place agent communication over signed-envelope WebSocket. - [bwoc-fleet-manager](https://github.com/bemindlabs/bwoc-fleet-manager): Web dashboard over the bwoc CLI for agent fleets. - [bwoc-chat](https://github.com/bemindlabs/bwoc-chat): Native desktop chat (egui): one agent or a whole team in one window. - [bwoc-mcc](https://github.com/bemindlabs/bwoc-mcc): SwiftUI macOS menu-bar control center for the agent fleet. - [bwoc-vscode-extension](https://github.com/bemindlabs/bwoc-vscode-extension): Operate the agent fleet from VS Code, a native surface over the bwoc CLI. - [bwoc-chrome-extension](https://github.com/bemindlabs/bwoc-chrome-extension): MV3 Chrome extension that drives the fleet over ed25519-signed requests. - [bwoc-plugin-claude](https://github.com/bemindlabs/bwoc-plugin-claude): Adapter for Claude Code: coordination, agents, skills and deep memory via the bwoc CLI. - [bwoc-plugin-codex](https://github.com/bemindlabs/bwoc-plugin-codex): Adapter for OpenAI Codex: coordination, skills and deep memory. - [bwoc-plugin-agy](https://github.com/bemindlabs/bwoc-plugin-agy): Adapter for Antigravity: coordination, skills, rules and deep memory. - [bwoc-plugin-cursor](https://github.com/bemindlabs/bwoc-plugin-cursor): Native Cursor plugin: /bwoc-* commands, fleet rule and skill, sub-agents. - [bwoc-plugin-hermes](https://github.com/bemindlabs/bwoc-plugin-hermes): Adapter for Hermes: tools, skills and a memory provider via the bwoc CLI. - [bwoc-plugin-openclaw](https://github.com/bemindlabs/bwoc-plugin-openclaw): Adapter for OpenClaw: coordination tools, agents, skills and a memory slot. - [bwoc-plugin-vercel](https://github.com/bemindlabs/bwoc-plugin-vercel): Universal fleet plugin installable with npx for Claude Code, Codex, Cursor, Copilot and Grok. - [bwoc-second-brain-view](https://github.com/bemindlabs/bwoc-second-brain-view): A living neural graph of a dev fleet: memory, repos, services and agents on one canvas. - [bwoc-speaker](https://github.com/bemindlabs/bwoc-speaker): Voice output (TTS) and voice input (STT) for agents, with per-agent voices. - [bwoc-penlee-sc01-plus](https://github.com/bemindlabs/bwoc-penlee-sc01-plus): ESP32-S3 fleet display firmware (robot-face chat and dashboard) plus a Tauri host app. ## Optional - [Full context for LLMs](https://bwoc.bemind.tech/llms-full.txt) - [Changelog](https://github.com/bemindlabs/bwoc-framework/blob/main/CHANGELOG.md)