Zero-config AI agent harness for seamless software development
BEOH is an open-source, all-in-one AI agent harness that combines multi-agent orchestration with structured agile methodologies. It auto-detects your project, loads appropriate tools, and orchestrates specialized AI agents to handle development tasks—from ideation to implementation.
- Zero Configuration: Auto-detects languages, frameworks, LSPs, and project patterns
- Multi-Agent Orchestration: Specialized agents collaborate like a development team
- Structured Workflows: BMAD methodology provides agile best practices
- Cross-Platform: Works on macOS, Linux, and Windows
- Open Source: MIT licensed, fully extensible
# Install BEOH
npx beoh@latest
# Navigate to any project
cd your-project
# Start BEOH
beoh
# That's it! BEOH auto-detects your stack and is ready to help.$ cd ~/my-fastapi-project
$ beoh
🔍 Analyzing project...
✓ Detected: Python 3.11, FastAPI, PostgreSQL, pytest
✓ LSP: pyright (loaded)
Ready! What would you like to build?
> Add JWT authentication with refresh tokens
┌─ Workflow: Quick Flow ────────────────────────────┐
│ ✓ Understand ● Design ○ Implement ○ Review │
└───────────────────────────────────────────────────┘
🏗️ Winston (Architect) [Working...]
└─ Designing authentication flow...
# Minutes later: Working JWT auth with tests!
┌──────────────────────────────────────────────────────────────┐
│ Your Natural Language │
│ "Add user authentication" │
└────────────────────────────┬─────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────┐
│ BEOH Orchestrator │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Analyst │→ │Architect│→ │Developer│→ │Reviewer │ │
│ │ (Mary) │ │(Winston)│ │(Amelia) │ │ (Code) │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
└────────────────────────────┬─────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────┐
│ Working Code + Tests │
│ Ready for review │
└──────────────────────────────────────────────────────────────┘
| Language | Frameworks | LSP |
|---|---|---|
| Python | FastAPI, Django, Flask, pytest | pyright |
| TypeScript/JavaScript | React, Next.js, Express, Jest | typescript-language-server |
| Go | Gin, Echo, Fiber | gopls |
| Rust | Actix, Axum, Rocket | rust-analyzer |
| Java | Spring Boot, Maven, Gradle | jdtls |
beoh # Interactive mode (default)
beoh init # Analyze project and show detection results
beoh run <task> # Execute a single task non-interactively
beoh session list # List saved sessions
beoh session resume # Resume last session
beoh config # View/edit configuration
beoh cost # Show token usage and costsBEOH works out of the box, but you can customize behavior:
# ~/.config/beoh/config.yaml
llm:
default_provider: anthropic
budget:
session_limit: 10.00 # USD per session
detection:
ignore_patterns:
- node_modules
- .git
- __pycache__# Required: At least one LLM provider API key
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
# Optional: Custom config location
export BEOH_CONFIG=~/.config/beoh/config.yamlBEOH uses a hybrid architecture:
- Go Core: High-performance CLI/TUI using Cobra and Bubble Tea
- Node.js Sidecar: BMAD workflow engine for agent orchestration
- IPC Bridge: Unix socket with MessagePack serialization
┌─────────────────────────────────────────┐
│ BEOH Main (Go) │
│ • CLI/TUI • LSP Manager • LLM Client │
│ │ │
│ IPC Bridge │
│ │ │
│ ┌─────────────────▼─────────────────┐ │
│ │ BMAD Sidecar (Node.js) │ │
│ │ • Workflows • Agents • BMB │ │
│ └───────────────────────────────────┘ │
└─────────────────────────────────────────┘
- Go 1.21+
- Node.js 20+
- Git
# Clone the repository
git clone https://github.com/CryptoDoru/BEOH.git
cd BEOH
# Install Go dependencies
go mod download
# Install Node.js dependencies
cd sidecar && npm install && cd ..
# Build
make build
# Run tests
make test
# Run locally
./bin/beohbeoh/
├── cmd/beoh/ # CLI entry point
├── core/ # Go core modules
│ ├── cli/ # Cobra commands
│ ├── tui/ # Bubble Tea UI
│ ├── detect/ # Project detection
│ ├── orchestrator/ # Agent orchestration
│ ├── agent/ # Agent runtime
│ ├── ipc/ # Go↔Node bridge
│ ├── llm/ # LLM providers
│ └── persistence/ # SQLite storage
├── sidecar/ # Node.js BMAD sidecar
│ ├── src/
│ │ ├── workflows/ # Workflow engine
│ │ └── agents/ # Agent definitions
│ └── package.json
├── agents/ # Agent YAML definitions
├── workflows/ # Workflow YAML definitions
└── docs/ # Documentation
BEOH builds upon these excellent projects:
- OpenCode - Go CLI/TUI foundation
- Oh My OpenCode - Multi-agent orchestration patterns
- BMAD-METHOD - Agile AI methodology and workflows
We welcome contributions! See CONTRIBUTING.md for guidelines.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Project planning and architecture
- Go core scaffold
- Node.js sidecar
- IPC bridge
- 5 core agents
- Quick Flow workflow
- Basic TUI
- VS Code extension
- Multi-LLM support (OpenAI, Ollama)
- Cost monitoring dashboard
- Additional workflows
- Web UI
- Agent marketplace
- Enterprise features
- Team collaboration
MIT License - see LICENSE for details.
- The Anthropic team for Claude
- The Charm team for Bubble Tea
- The BMAD community for methodology inspiration
BEOH - Making AI-driven development seamless