fbt-os

v0 setup CLI for the FuckBigTech local-first agent OS. Zero deps. Zero network calls. Nothing leaves your machine.

⚠️ v0 scope. This CLI scaffolds a private local memory vault, detects which agent harnesses + runtimes + provider keys are present on your system, and runs deterministic setup checks. The full agent OS — autonomous meta-routing, prompt decomposition, cloud-burst, vault-aware harness plugins — is being built. Star the project / subscribe at fuckbigtech.ai for the v1 drop.

The npm package is fbt-os (npm's word filter blocks the full brand name). The installed binary keeps the brand: type fuckbigtech after install.

Install

npm install -g fbt-os

Requires Node 20+. Works on macOS, Linux, WSL.

Verify before running

fuckbigtech dry-run

Prints everything the CLI would do without doing it. No writes, no env reads, no shells.

Initialize a local memory vault

fuckbigtech init --with-memory

Scaffolds a private Markdown memory tree under ~/.fuckbigtech/memory/ (mode 0700, files 0600). The --with-memory flag is an explicit opt-in.

Run setup checks

fuckbigtech doctor          # detect harnesses, runtimes, provider key presence (boolean only — values never read)
fuckbigtech memory-test quick   # validate the local vault scaffold
fuckbigtech route-test demo     # exercise the v0 route classifier

Connect an existing vault

fuckbigtech connect /path/to/your/vault

Validates the path looks like an FBT-shaped memory tree before writing the config pointer.

What this CLI promises

• No network calls. grep -rE 'fetch|http|https|net|dgram' bin/ returns zero hits.
• No paid model calls. All routing decisions in v0 are deterministic and offline.
• No key uploads. Provider env keys (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.) are tested for presence only with a boolean — the values are never read, logged, or written.
• No shell mutation. Doesn't touch your .bashrc, .zshrc, PATH, or any system path. All writes are scoped to ~/.fuckbigtech/ (override via FBT_CONFIG_DIR and FBT_VAULT_PATH).
• Permissive defaults. Vault dir is 0700, files 0600 — only your user can read.

What v0 doesn't do yet

• Autonomous prompt routing across harnesses (Claude / Codex / OpenCode / Hermes).
• Multi-part prompt decomposition.
• Cloud-burst with git-worktree-based vault sync.
• The oc meta-router with the Llama 3.3 70B routing model.

These ship in v1. For the canonical product spec see fuckbigtech.ai.

License

MIT. See LICENSE.