brew-browser v0.2.0

A structural overhaul of the UI since v0.1.0 — title bar, sidebar, info popovers, and a smarter sign-in flow. Same MIT-licensed, telemetry-free, account-free desktop app on top of brew.

What's new

Native macOS title bar

• Unified title bar (36 px) above the main split — Mail / Notes / Messages-style chrome
• macOS traffic lights, sidebar toggle, and the active page title all centered on the same horizontal axis (via trafficLightPosition)
• Sidebar toggle position adapts: just inside the sidebar divider when expanded, next to the traffic lights when collapsed
• New right-side cluster: theme dropdown (☀ / 🌙 / 🖥 with a popover picker) + Settings gear + pink Donate heart, grouped as one rounded pill
• Right edge aligns with the panel content's right padding — nothing hangs over

Collapsible sidebar with persistent type-ahead search

• New search input at the top of the sidebar — debounced 300 ms against brew_search; top 7 hits with kind pill + installed badge; ArrowUp/Down + Enter + Esc keyboard support
• "See all results in Discover →" affordance at the bottom of the dropdown
• Dashboard is now the first nav item (the menu bar already identifies the app — no more redundant "brew-browser" brand)
• Sidebar collapses to a 56 px icon rail; nav items show a badge overlay, search hides, theme/Settings/Donate live in the title bar now
• Collapsed state persists across launches (localStorage)

Info popovers replace AI labels & "Wrong?" links

• New (i) info button on every enriched field — Categories, Tags, Summary, "Why install this?", "Similar packages"
• Hover-activated (mouse) + focus-activated (keyboard); auto-closes on scroll / Esc / outside-click
• Each popover discloses the AI provenance ("Generated offline at build time by Claude Haiku 4.5 — no network or LLM calls happen while you use brew-browser") and offers a "Report an issue on GitHub" action
• Removed the "AI-enriched" pill badges entirely — provenance is one tap away on every field, not bolted onto every label

Intent-based GitHub sign-in

• No more static "Sign in via Settings → GitHub to star, watch, or file issues." prompts on every package
• Star / Watch / File issue buttons render whenever the GitHub stats card is visible
• Clicking while signed-out deep-links to Settings → GitHub and toasts a hint (intent-based discovery)
• Settings now supports ui.openSettings("github")-style deep-links so any caller can drop the user directly on a specific section
• GitHub OAuth client_id is live — sign-in works out of the box (no BUILD.md setup required)

Smaller fixes

• License-mismatch row wraps as prose instead of fragmenting into a column grid
• Every empty state in the app is vertically centered in its pane (not stuck at the top)
• Snapshots' inline "New Snapshot" / "Import Brewfile…" buttons removed from the empty state — the same actions live in the panel-head's top-right
• Selected row stays highlighted across Library / Trending / Discover / Services / Dashboard outdated while the detail panel is open
• Chip-filter clears when crossing panes (Productivity-in-Discover no longer silently filters Library to zero)
• App icon redesigned as a native macOS Tahoe square — no more white-corner artifacts from the OS auto-mask

Open-source posture (unchanged)

MIT licensed. No telemetry. No accounts. No CLA. No EULA.

Seven documented outbound network paths, all gated by Settings → Network → Paranoid Mode. Token (when you sign in) lives only in macOS Keychain, never returned to the frontend, never written to disk.

Built with Agency Agents, by the creator of Agency Agents. Powered by Anthropic's Claude Opus 4.7 and the Claude Agent SDK.

If brew-browser saves you time, sponsor on GitHub ♥.

Install

Download the signed + notarized .dmg below, open, drag to Applications. No Gatekeeper warning.

macOS 13 (Ventura) or newer · Apple Silicon.

Full changelog

• Commit range: v0.1.0...v0.2.0
• Memory bank breakdown: memory-bank/progress.md