Skip to content

erbina v0.1.0

Choose a tag to compare

View all tags
@noahhyden noahhyden released this 18 Jul 16:29
v0.1.0
d5042a9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First tagged release of erbina — a Claude-Code-only MCP server that bootstraps your dev environment from one prompt: install, wire, and verify CLI tools and MCP servers from curated recipes, keep them updated, and audit where every MCP server lives across your scopes.

erbina ships as source — a single server.py run by uv, no build step, no venv.

Install

git clone https://github.com/noahhyden/erbina
claude mcp add erbina --scope user -- uv run --script /absolute/path/to/erbina/server.py

Then just ask Claude: "use erbina to set up ripgrep."

Highlights

Recipe contract — detect → install → configure → verify. One YAML per tool; idempotent by construction (detect gates install), and success means the tool actually runs, not that a config line was written.

9 tools: list_recipes, inspect_recipe, bootstrap, check_updates, update, pin, audit_scopes, find_dead_mcps, remove_mcp. Consent-first: inspect_recipe / bootstrap(dry_run=true) show the exact commands before anything runs.

Auto-updating tools. A recipe can declare a version: block; check_updates compares installed vs latest (packaging semantics, never a false positive), update upgrades then re-runs verify as a safety net — rolling back to the prior version (via $ERBINA_ROLLBACK_VERSION) or marking the tool broken on failure. State lives in ~/.erbina/state.json; pin opts a tool out. Opt-in SessionStart//schedule triggers included.

22 recipes — 16 CLI tools (ripgrep, fd, jq, bat, delta, zoxide, eza, uv, hyperfine, dust, bottom, sd, tokei, tealdeer, procs, ataegina) and 6 MCP servers (fetch, git, time, sequentialthinking, memory, everything, via uvx and npx). See the Recipe gallery.

Scope-aware. Understands Claude Code's local / project / user scopes, wires mcp-server recipes into the right one, and audits all three.

Quality

  • 417 tests — unit, property-fuzz, recipe conformance, and real end-to-end (a fixture tool genuinely installed into a temp PATH and verified by execution; mcp-server wiring against a stub claude; rollback recovery). Every behavioral test is validated by mutation testing.
  • Two-layer linter — schema (validate_recipe, enforced at load time) plus curated-registry policy (title/description, guarded install methods, and an honest verify).
  • CI on Linux + macOS, a Python 3.10 floor check, and a release-verify guardrail.

Full details in the CHANGELOG.

MIT licensed. Published to the MCP registry as io.github.noahhyden/erbina.

Assets 2
Loading