Skip to content

feat: add Better Search, one popup to find tabs, agents, files, commands, PRs and issues - #43

Open
munza wants to merge 1 commit into
mainfrom
better-search
Open

munza wants to merge 1 commit into
mainfrom
better-search

Conversation

@munza

@munza munza commented Nov 19, 2026

Copy link
Copy Markdown
Owner

Summary

A new mod, Better Search (⌘⌥P): one popup that finds any tab on any machine, agents, spaces, files, Herdr's commands, what agents printed, pull requests and issues.

Better Search

⌘⌥P (nothing typed)  every tab, ones that need you first ("needs you · 3m") with the agent's question; opens on the last tab
@  agents, waiting first, state on the right      >  commands, recent first
/  files (git ls-files)                            ~  spaces
?  lines agents printed                            #  pull requests (Branch PR)     $  issues (Branch Issue)
↵ go · ⇧↵ peek · ⌘↵ message an agent / hand it a file / open a PR's link · Tab: show a whole section
+better-search/                 # model.js (pure: prefixes, rows, ranking), main.js (popup), tests
+estro/mods/better-search/      # pointer, as for the other mods
 branch-pr/      2.4 → 2.5.0    # + opens the PR in shared branch-pr.open, with "Loading #7…"
 branch-issue/   2.2 → 2.3.0    # + same, for branch-issue.open
 better-config/  0.2 → 0.3.0    # + Key setting: moves Search's binding in keys.json, gives back a key it took over
 README.md, site/mods.json, docs/, estro/   # list it

Opening a PR or issue from Search:

sequenceDiagram
    participant Search as Better Search
    participant Herdr
    participant Panel as Branch PR / Branch Issue
    Search->>Herdr: setShared("branch-pr.open", {space, number, repo, at})
    Search->>Herdr: layout.select / layout.show (its stack)
    Panel->>Herdr: every 100ms: shared("branch-pr.open")
    Panel->>Panel: fresh (<10s) and this space → "Loading #7…" → openPR
Loading

With neither panel in the layout, Enter opens the link in the browser.

Evidence

  • Before: no way to jump to a tab or agent by typing. Herdr's picker and palette are separate, local, and know nothing about PRs or agent output.
    After: checked in the running app with screenshots:
  • Tests: node --test */tests/*.test.cjs site/tests/*.cjs: 433 pass, 0 fail.
    better-search: parse/fuzzy, tab urgency order, last tab, askOf, outputRows, prRows/issueRows, reveal, drill, "5 of N"
    branch-pr / branch-issue: a fresh ask in this space opens it with "Loading …"; a stale one or another space's is ignored
    better-config: Key rebinds keys.json, takes over a used key and gives it back
    
  • herdr-app check passes for better-search, better-config, branch-pr and branch-issue, and the site builds.
  • Not checked by hand:
    • clicking a chip
    • Tab on a section
    • a real question from a waiting agent
    • ⌘↵ opening a link
    • a full message send
    • Better Config's Key setting in the app
    • opening an issue in the panel (the Branch Issue installed here is 3.0, which isn't on main and lacks the listener)

Merge Danger

Door: two-way

Better Search is a new mod. The changes to the other three only add things: a polled shared key and a new setting. Reverting removes them without any migration.

Blast Radius: Panels

  • Branch PR and Branch Issue now poll shared() every 100 ms. That's cheap, but it runs in every copy of them.
  • A Search ask reopens the panel on that item and drops an unsaved composer: the same as picking another PR in the panel yourself.
  • Better Config's Key setting edits keys.json, but only when the person changes it there.
  • keys.json changes only with the person's agreement at install.

🤖 Generated with Claude Code

…nds, PRs and issues

Better Search (⌘⌥P) lists every tab on every machine, the ones that need
you first with the agent's question, opens on the tab you were in last,
and narrows with a prefix: @ agents, > commands, / files, ~ spaces,
? agent output, # pull requests, $ issues. Shift+Enter peeks, Cmd+Enter
messages an agent or hands it a file.

Branch PR 2.5.0 and Branch Issue 2.3.0 open what Search picks, from shared
branch-pr.open / branch-issue.open, with a busy sign until it loads.
Better Config 0.3.0 adds the Key setting that moves Search's binding in
keys.json and gives back a key it took over. The site, Estro and the root
README list it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant