Skip to content

observal-cli 0.7.0 (new formula)#284024

Open
Apoorvgarg-creator wants to merge 1 commit into
Homebrew:mainfrom
Apoorvgarg-creator:observal-cli-0.7.0
Open

observal-cli 0.7.0 (new formula)#284024
Apoorvgarg-creator wants to merge 1 commit into
Homebrew:mainfrom
Apoorvgarg-creator:observal-cli-0.7.0

Conversation

@Apoorvgarg-creator
Copy link
Copy Markdown

@Apoorvgarg-creator Apoorvgarg-creator commented May 21, 2026

  • Have you followed the guidelines for contributing?
  • Have you ensured that your commits follow the commit style guide?
  • Have you checked that there aren't other open pull requests for the same formula update/change?
  • Have you built your formula locally with HOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source observal-cli?
  • Is your test running fine brew test observal-cli?
  • Does your build pass brew audit --strict observal-cli (after doing HOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source observal-cli)? If this is a new formula, does it pass brew audit --new observal-cli?

  • AI was used to generate or assist with generating this PR. Please specify below how you used AI to help you, and what steps you have taken to manually verify the changes.

AI disclosure

Claude (Anthropic) was used as a pair-programming assistant to scaffold the formula and the resource blocks. Specifically:

  • The runtime dep list (url, sha256, every resource block) was machine-derived from a clean pip install observal-cli==0.7.0 in a throwaway uv venv, then each (url, sha256) pair was fetched directly from https://pypi.org/pypi/<name>/<version>/json. No values were generated from model memory.
  • The formula skeleton (depends_on, install method, test block) was adapted by hand from existing homebrew-core Python virtualenv formulae such as octodns.rb and harlequin.rb.
  • Manual verification I performed locally on macOS 26.3 (arm64, Tier 2) before opening this PR:
    • brew style observal-cli → no offenses.
    • brew audit --strict --online --new --formula observal-cli → exit 0.
    • HOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source observal-cli → installs from sdist cleanly.
    • brew test observal-cli → exit 0.
    • observal --version from the brew prefix prints observal 0.7.0.
    • ruby -c Formula/o/observal-cli.rb is clean.

What is observal-cli?

observal-cli is the command-line interface for Observal, an open-source (AGPL-3.0) self-hosted AI agent registry with built-in observability. The CLI lets users:

  • Browse and install AI coding-agent configurations from a registry (think Docker Hub for AI agents).
  • Publish their own agents bundled with MCP servers, skills, hooks, prompts and sandboxes.
  • Authenticate with a self-hosted Observal server and connect supported IDEs (Claude Code, Kiro, Cursor, Gemini CLI, Codex CLI, OpenCode, VS Code, Copilot CLI) so every interaction produces traces, spans and session telemetry.

Upstream is at https://github.com/BlazeUp-AI/Observal (1,100+ stars, 140+ forks, AGPL-3.0-only, stable Beta — the 0.7.0 sdist published to PyPI carries Classifier: Development Status :: 4 - Beta).

Notes

  • Pure-Python virtualenv formula using Language::Python::Virtualenv. The only system deps are rust (build-time, for asyncpg's small native shim when wheels aren't preferred) and libyaml (for pyyaml).
  • The optional [migrate] extra (which adds pyarrow for Parquet export/import) is deliberately omitted from the formula; users who need the migration commands can install via pip install 'observal-cli[migrate]' or uv tool install 'observal-cli[migrate]' separately. This avoids dragging Apache Arrow into a default install.
  • head is wired to the upstream main branch for HEAD installs.
  • Upstream maintains its own tap at https://github.com/BlazeUp-AI/homebrew-observal shipping the PyInstaller release binaries; this PR is the source-build formula intended for homebrew-core.

@github-actions github-actions Bot added python Python use is a significant feature of the PR or issue new formula PR adds a new formula to Homebrew/homebrew-core rust Rust use is a significant feature of the PR or issue labels May 21, 2026
Comment thread Formula/o/observal-cli.rb
Comment on lines +30 to +33
resource "certifi" do
url "https://files.pythonhosted.org/packages/f3/ce/ee2ecad540810a79593028e88299baeae54d346cc7a0d94b6199988b89b1/certifi-2026.5.20.tar.gz"
sha256 "69dea482ab64caa7b9f6aba1c6bf48bb6a5448d1c0f1b17ab42ad8c763a5344d"
end
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

replace with formula:

depends_on "certifi" => :no_linkage

pypi_packages exclude_packages: "certifi"

Comment thread Formula/o/observal-cli.rb

depends_on "rust" => :build # asyncpg has a small C+Rust build step on non-wheel installs
depends_on "libyaml" # pyyaml
depends_on "python@3.13"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why not the latest Python?

Comment thread Formula/o/observal-cli.rb
Comment on lines +135 to +139
output = shell_output("#{bin}/observal --version")
assert_match(/observal/i, output)

help_output = shell_output("#{bin}/observal --help")
assert_match "Usage", help_output
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
output = shell_output("#{bin}/observal --version")
assert_match(/observal/i, output)
help_output = shell_output("#{bin}/observal --help")
assert_match "Usage", help_output
assert_match version.to_s, shell_output("#{bin}/observal --version")

Homebrew requires a simple test that checks if a program can do basic stuff correctly. From Formula Cookbook:

We want tests that don’t require any user input and test the basic functionality of the application. For example foo build-foo input.foo is a good test and (despite their widespread use) foo --version and foo --help are bad tests. However, a bad test is better than no test at all.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new formula PR adds a new formula to Homebrew/homebrew-core python Python use is a significant feature of the PR or issue rust Rust use is a significant feature of the PR or issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants