🥾 b00t — Agentic Hive OS
"Tell me what I'm running on, what tools are available, what I'm allowed to do, what goals I should optimize for, and where the boundaries are."
b00t is a context-aware agentic operating layer: tool discovery, version management, tribal knowledge, multi-agent coordination, and MCP integration — batteries included.
⚡ Install
curl -fsSL https://raw.githubusercontent.com/elasticdotventures/_b00t_/main/install.sh | bash
Downloads the binary from GitHub Releases and verifies its SHA256 checksum when possible. Supports Linux x86_64/aarch64/armv7 and macOS Intel/Apple Silicon.
From crates.io:
cargo install b00t-cli
From source:
git clone https://github.com/elasticdotventures/_b00t_.git
cd _b00t_ && cargo install --path b00t-cli
🚀 Quick Start
b00t --version
b00t status # check tool versions vs desired
b00t cli check rust # is rustc installed?
b00t cli install uv # install/upgrade to desired version
b00t cli up # check all datums
b00t cli up --yes # update all tools to desired versions
b00t learn rust # load Rust dev context into agent session
b00t learn docker # container orchestration knowledge
b00t lfmf rust "PyO3: unset CONDA_PREFIX before cargo build to fix linker errors"
b00t advice rust "PyO3" # retrieve lessons for a tool+pattern
🤖 MCP Integration
Claude Code Marketplace (recommended)
# In Claude Code, add the b00t marketplace plugin
/plugin marketplace add elasticdotventures/_b00t_
/plugin install b00t@b00t-plugins
/plugin install skill-document-understanding@b00t-plugins
Provides /b00t skill, context-aware tool dispatch, and all available b00t skills.
Bundles publish deterministic MCP recipes at .claude-plugin/recipes/{skills,roles}/*.json
(for example: skill-document-understanding provides docling-mcp + fetch-url-as-markdown).
Direct MCP Server
b00t mcp install b00t claudecode # Claude Code
b00t mcp install b00t vscode # VS Code
b00t mcp list # list available MCP servers
50+ MCP tools exposed via b00t-mcp — b00t_up, b00t_status, b00t_learn, b00t_lfmf, b00t_advice, and more.
🐝 Hive Coordination
# Multi-agent mission coordination
b00t acp hive create mission-id 3 "Build and deploy microservice" leader
b00t acp hive join mission-id developer
b00t acp hive sync mission-id 1 # barrier: wait for all agents at step 1
b00t acp hive ready mission-id 2 # signal readiness for step 2
🔁 Ralph — OODA Loop Runner
b00t.sh implements the Ralph autonomous task loop (Observe→Orient→Decide→Act):
# Run with default claude tool, 10 iterations
bash b00t.sh
# Configure via env or flags
TOOL=mistralrs bash b00t.sh --max-iterations 5 --role executor
bash b00t.sh --tool codex --sleep 1
Tools: claude, codex, amp, opencode, mistralrs (local vLLM).
Loop exits on EXIT_SIGNAL=true in LLM output, or exit 75 (tempfail/restart) after max iterations.
📦 Datums
Datums in _b00t_/ declare tools with detect/install/desires/hint. b00t resolves DAG-ordered installs:
b00t cli detect fastmcp # run datum detect script
b00t cli desires rust # show target version
b00t cli install fastmcp # install: python → uv → fastmcp (DAG-aware)
🧠 Session & Budget Management
b00t session init --budget 25.00 --time-limit 120 --agent "code-reviewer"
b00t session status
b00t checkpoint "completed feature X"
🌐 Platform Support
| Platform | Architecture | Status |
|---|---|---|
| Linux | x86_64 | ✅ |
| Linux | aarch64 | ✅ |
| Linux | armv7 | ✅ |
| macOS | Intel | ✅ |
| macOS | Apple Silicon | ✅ |
🛠 Development
git clone https://github.com/elasticdotventures/_b00t_.git && cd _b00t_
cargo build
cargo test --workspace
just -l # available recipes
just release # dispatch GitHub release workflow
Release pipeline: release.yml (tag + GitHub Release) → build-release.yml (cross-platform binaries) → publish-crates.yml (crates.io).
📖 Docs
- b00t Gospel — philosophy and architecture
- Agent Guide — agent operation protocol
- CLAUDE.md — LLM alignment instructions
- Release Notes — changelog
Issues / hive recruitment: github.com/elasticdotventures/b00t/issues