Menu
Build a static `bd` binary when Homebrew is unavailable or its dynamically-linked package is not portable enough for the machine.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Surface open PRs that have genuinely unaddressed review feedback, filtering out CodeRabbit auto-summaries and CI-bot noise. Use before ending a session, when asked "which of my PRs need attention", or to gate a session close on unresolved review threads.
Sync git repository with upstream. Use at the start of a session, when asked to sync, get up to date, check git status, or when working on a stale branch.
Analyze content and generate illustrations via Gemini image API
Brainstorm multiple visual directions for a blog image, generate them in parallel, build a comparison page, and optionally publish as a shareable link (Surge.sh or gist).
Bulk-parallel CLIs — turn N sequential gh/bd/git/file tool calls into a single fan-out JSON call. Use when the session is about to fire ≥3 similar sequential calls (gh pr view, bd show, Read of small files, up-to-date diagnose across repos).
Extract durable lessons from a completed Claude session and codify them in the right CLAUDE.md files or skills. Use at the end of a long session, after a bug hunt that surfaced a non-obvious constraint, or when the user asks "what can we learn from this session". Discovers CLAUDE.md files dynamically, routes lessons by generic scope (project / shared conventions / environment / machine-local), enforces neutral voice, and asks for approval before editing.
| name | build-bd-static |
| description | Build a static `bd` binary when Homebrew is unavailable or its dynamically-linked package is not portable enough for the machine. |
| allowed-tools | Bash, Read |
Use Homebrew as the default install path:
brew install beads
brew upgrade beads
Use this skill only when Homebrew is unavailable, or when the packaged bd is not enough because you need a self-contained binary that avoids shared-library issues (for example ICU version mismatches across machines).
bd upgrade is not the installer path here; it reviews version changes but does not replace the binary.
/build-bd-static
Check current version:
bd --version 2>/dev/null || echo "bd not installed"
Find the latest available version:
go list -m -json github.com/steveyegge/beads@latest 2>&1 | grep '"Version"'
If already on the latest version, report that and stop. Otherwise, proceed to build the static fallback binary.
Build the latest version statically with CGO disabled:
CGO_ENABLED=0 go install github.com/steveyegge/beads/cmd/bd@latest
@latest resolves at install time, so there's no need to pass the version from step 2 — that step is just for the "already on latest?" gate.
CGO_ENABLED=0 forces pure-Go alternatives for all dependencies (ICU regex, SQLite, etc.), producing a binary with zero shared library dependencies.
macOS warning:
CGO_ENABLED=0can cause crashes (e.g., duringbd init) due to CGO/SQLite incompatibilities on macOS. macOS users should useCGO_ENABLED=1instead — see upstreamdocs/INSTALLING.mdfor details.
Verify:
bd --version
# Linux:
ldd "$(which bd)" 2>&1 # Should say "not a dynamic executable"
# macOS:
otool -L "$(which bd)" # Should show no external library entries
The bd binary uses go-icu-regex (CGo) which links against the system's ICU library. Different machines have different ICU versions (e.g., Homebrew's icu4c@77 vs system libicu76), causing runtime failures:
bd: error while loading shared libraries: libicui18n.so.77: cannot open shared object file
Static compilation eliminates this entirely.