Skip to content

v0.2.0 — simplify install + bootstrap

Choose a tag to compare

View all tags
@the-sid-dani the-sid-dani released this 19 May 06:11
· 7 commits to main since this release
v0.2.0
1686131

The big one. Knowledge-worker default tier now ships in ~3-5 minutes. CCv4 toolchain (Rust/uv/bloks/tldr/FastEdit) is opt-in via --with-coding. Bootstrap slimmed 929 → 498 LOC. .mcp.json ships with 3 universal MCPs only — zero red errors on a fresh fork's first claude launch.

Re-extracted from daily-agents@f958d29.

Headlines

  • Tier model. ./scripts/install.sh = minimal (knowledge-worker default). ./scripts/install.sh --with-coding = adds Rust + uv + bloks + tldr + FastEdit MCP. Tier marker SBOS_TIER=minimal|coding lands in ~/.second-brain-os.env and /bootstrap Step 2 reads it.
  • Bootstrap slimmed 929 → 498 LOC (-46%). 8 narrated steps merged to 6. T1-T4 invariants preserved canonically with point-of-use refs. Affective moments ("Meet your assistant:" echo-back; voice-synthesis preview-before-write gate) preserved verbatim.
  • assistant.pronoun field added (she / he / they / no-pronouns). All <him/her/them> placeholder literals eliminated.
  • .mcp.json 3-universal defaults — gemini-vision (local stdio), exa (HTTP), firecrawl (HTTP). Slack/Atlassian/Figma are opt-in via bootstrap Step 2.5 multi-select; canonical entries live in .mcp.json _notes.opt_in_* as the single source of truth.
  • firecrawl MCP added as the third universal default (https://mcp.firecrawl.dev/v2/mcp). Auth via FIRECRAWL_API_KEY shell env.

Added

  • --with-coding tier flag + SBOS_TIER marker
  • --with-ripgrep opt-in flag (ripgrep no longer auto-installed; /find falls back to grep -r)
  • ASCII logo opener + closing summary card + duration + ~/.claude/install.log tee
  • --doctor flag (working stub in v0.2.0 — read-only probe of foundation/tier/coding-tier/MCP/log; full implementation in v0.3.0)
  • assistant.pronoun Configuration token
  • Day 2+ rhythms externalized to beru-workspace/3-Resources/onboarding/day-2-plus.md
  • Bootstrap Step 2.5 — interactive MCP opt-in multi-select for Slack/Atlassian/Figma
  • firecrawl MCP in .mcp.json defaults
  • GEMINI_API_KEY and FIRECRAWL_API_KEY in .env.example (and the matching HEREDOC in scripts/lib/api-keys.sh)

Changed

  • Bootstrap SKILL.md rewritten — 8 → 6 steps; T1-T4 canonical-only with single-line step-header refs; failure-modes table 18 → 10 rows; Step 4b voice synthesis collapsed three branches into one spec with the preview-before-write gate preserved
  • INSTALL.md rewritten for the tier model — Path A (minimal) + Path B (coding)
  • README.md Forking section reframed as 2-layer install (system tools / persona + workspace)
  • README-template.md aligned with tier model (collapsed old Lite-CCv4 / Full paths into single --with-coding flag)
  • .env.example sectioned by purpose (default-MCP keys / skill-only keys / opt-in connector keys), 7 keys total
  • TOOLS.md MCP + env sections rewritten; SBOS_TIER + FIRECRAWL_API_KEY documented
  • scripts/lib/api-keys.sh no longer prompts — writes annotated .env.example only

Removed

  • ffmpeg + yt-dlp auto-install (zero active skills consumed them; pre-existing brew installs untouched)
  • Slack / Atlassian / Figma from default .mcp.json mcpServers (still available via bootstrap Step 2.5 opt-in)
  • ffmpeg / yt-dlp probes from verify.sh

Deferred to v0.3.0

  • Cross-platform Python rewrite + Windows port (W4)
  • Full --doctor implementation with remediation hints (W5)

Upgrading

git pull
./scripts/install.sh                 # if you want the minimal-tier upgrade path
./scripts/install.sh --with-coding   # if you want the full toolchain

The installer is idempotent and additive — existing forks get the new tier marker written automatically; nothing else regresses.

Acceptance gate

  • Bootstrap LOC < 500 ✅ (498)
  • 3 default MCPs ✅
  • Tier gating + SBOS_TIER marker ✅
  • Zero "what's bloks?" jargon on minimal tier ✅
  • Extractor PHASE 10 leakage scan: PII clean, path-refs clean, samba-tools-setup clean ✅
  • shellcheck + bash syntax + --help + --doctor smoke: all green ✅
  • Fresh-VM empirical M1/M2 (time-to-first-/briefing < 15 min; default install < 5 min): structurally gated, recommend fork users measure on their own machine

🤖 Generated with Claude Code

Assets 2
Loading