Skip to content

Homebrew formula is frozen at 0.51.1 and ships a different feature set than install.sh #2320

Description

@Q00

Problem

brew install q00/tap/ouroboros-ai installs 0.51.1 (tapped 2026-08-11) while PyPI is at 0.52.0. Nothing bumps the formula, so brew users have missed every release since: 0.51.2 through 0.51.17, and now 0.52.0.

release.yml has four jobs — release, build-tui, attach-tui-binaries, publish — and none of them touch the tap. There is no brew/formula/tap reference anywhere in .github/workflows/ or scripts/.

The formula is not just old — it is a different build

The formula vendors its dependency graph as resource blocks, and that graph was generated without extras:

extra pyproject.toml formula
mcp mcp==2.0.0 present
tui textual, textual-serve missing
claude claude-agent-sdk, anthropic missing
litellm litellm missing

So a brew user cannot run the settings GUI (ooo config needs [tui]) and cannot select the Claude SDK runtime. #2307 made ouroboros-ai[mcp,tui] the installer default, which widens the gap further.

Installs also diverge in setup, not only in contents: the formula's def install is virtualenv_install_with_resources and nothing else, so the Claude plugin registration, MCP configuration, telemetry ref stamp, and first-run ooo config that install.sh performs are all absent.

Also found

  • brew audit --online fails on the formula as it stands today: PyYAML needs depends_on "libyaml". Pre-existing at 0.51.1 — audit appears never to have been run.
  • q00/oouro-dev is a stale local tap holding a duplicate formula. Its remote (Q00/homebrew-oouro-dev) returns 404 and it tracks no files. It makes brew info ouroboros-ai fail with "Formulae found in multiple taps". Local-only, so it needs no repo change — brew untap q00/oouro-dev.

Proposal

Bump the formula from release.yml after the PyPI publish, regenerating resources for [mcp,tui] so brew and install.sh stay on one profile. Verify (audit, install --build-from-source, test) before pushing to the tap, and fail the job when the tap token is missing rather than skipping quietly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugReproducible defect or broken behaviorneeds-approvalTouches protected boundaries (SOUL.md, AGENTS.md, CI, security)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions