# Homebrew Formula Updates Brief

> Homebrew Formula Updates Brief is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Returns an LLM-generated digest summarizing the most consequential Homebrew formula updates and breaking changes within a specified time window, with upgrade guidance.

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/homebrew/brief
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/homebrew-formula-updates-brief-b1ed5407
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CdwKvHVPjBmW4x5A_k1sA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability homebrew-formula-updates-brief-b1ed5407
```

Example prompt: Give me an LLM-written digest of the most important Homebrew formula updates and breaking changes since January 1, 2025, with upgrade guidance.

## When to prefer this

Choose this endpoint when you need a concise, human-readable summary of Homebrew formula updates and breaking changes rather than raw changelog data. It is ideal for developers who want actionable upgrade guidance without manually scanning formula diffs or release notes. Prefer this over raw package registry scraping when you want LLM-synthesized analysis of which changes actually matter.

## Known failure modes

- Invalid or unparseable 'since' date-time format returns a 400-level error
- No formula changes found in the requested window may return an empty or minimal brief
- LLM generation failure may fall back to template-based output (generatedBy: 'template')
- Payment not completed or invalid x402 credentials results in 402 Payment Required
- Service unavailability on Railway returns 5xx errors

## How this service works

Plain-English digest of the Homebrew formula ecosystem: which tracked packages (git, node, python@3.13, go, and more) shipped notable or breaking major releases since T, why they matter, and whether to bump your Brewfile / brew upgrade.

## Output

Returns a structured object with a 'brief' field containing a natural-language LLM-written summary of the most consequential Homebrew formula updates and breaking changes in the requested window, a 'generatedBy' field indicating whether it was produced by an LLM or a template, and a 'basedOnChanges' integer indicating how many formula changes were analyzed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "since": {
       "type": "string",
       "format": "date-time",
       "description": "Window start (default: last 30 days)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "brief": {
       "type": "string"
      },
      "generatedBy": {
       "enum": [
        "llm",
        "template"
       ],
       "type": "string"
      },
      "basedOnChanges": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/homebrew-formula-updates-brief-b1ed5407/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracles-production.up.railway.app](https://www.zero.xyz/host/oracles-production.up.railway.app/llms.txt)