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.