Guide
Philosophy
What ModelBuff builds — and deliberately refuses to build — rests on five engineering principles.
01
Official CLI, driven natively
No proxies or cloaking — run the official CLI natively inside a clean sandbox and stay current automatically.
We do
- Native upstream CLI — uses official auth and traffic flows with zero version lag
- Open protocols — drives agents via ACP and exposes media tools via MCP
- Standard formats — local gateway speaks OpenAI, Anthropic, and Gemini
We don't
- No token extraction — never lifts subscription tokens into a relay proxy
- Zero cloaking — never rewrites or strips system prompts
02
Isolated sandbox + browser, fail-closed
Each account gets its own sandbox, fixed exit, and one-click account browser; if isolation breaks, it stops rather than leaking.
We do
- One-click browser — reuses native Chrome/Edge with per-account profiles and color badges
- Born-clean parity — keeps host credentials out, aligns timezone & locale with the exit, and blocks DNS & WebRTC leaks
- Directory × group locks — runs same-vendor plans concurrently with strict work/personal boundaries
We don't
- No degraded fallback — aborts immediately if sandbox or exit fails
- No silent leaks — never falls back to host home or direct connection
03
100% local, built for one person
A personal workstation on your computer — credentials, prompts, and ledgers never leave disk.
We do
- Local-only storage — logins, API keys, and dual-source usage stay on your machine
- Direct to providers — requests go straight from your machine with zero relay servers
- Redacted gateway — binds
127.0.0.1:28330, masking keys and aliasing paths reversibly
We don't
- No cloud account — zero sign-up and zero prompt or telemetry upload
- No shared resale — never built for multi-user pools or subscription resale
04
Millisecond core, one machine is enough
Far lighter than VMs or Docker — isolation and scheduling should never slow you down.
We do
- < 5 MB resident — custom featherweight sandbox (~3 MB measured per session)
- ~45 ms launch — full sandbox + fixed exit adds ~45 ms (~3 ms for identity switch)
- Standalone CLI — zero GUI dependencies across macOS, Linux, and WSL2
We don't
- No heavy VMs — never spins up a full OS or container image per account
- No cloud boxes — one local machine runs every isolated environment concurrently
05
MIT open source, open ecosystem
Every component touching your credentials, configs, and protocols is MIT-licensed and auditable.
We do
- Open client & protocol — desktop app, CLI, redaction gateway, media MCP, and schemas are MIT
- Plain local files — transparent configs and keys with zero vendor lock-in
- Read-only import — migrates CC Switch, Magpie, OpenCode, and
ccswitch://cleanly
We don't
- No config mutations — never alters your existing third-party tool configs
- No closed silos — embraces open plugins and standard protocols
Boundary — Sandboxing, multi-hop exits, and dual-window pacing run in the bundled mb-engine runtime over public contracts.