Skip to content

Document the fzf version floor; stop naming brew on Linux #48

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
devcodes9 merged 2 commits into from
Aug 22, 2026
Merged

Document the fzf version floor; stop naming brew on Linux #48

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
165edce
Name the fzf command for the machine, not for macOS
devcodes9 Aug 22, 2026
02aaa62
Document the fzf version floor; stop naming brew on Linux
devcodes9 Aug 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,8 +70,10 @@ uv tool install agsearch
pipx install agsearch
```

Install [`fzf`](https://github.com/junegunn/fzf) separately for the interactive interface.
Without it, `agsearch -n "query"` still works.
The interactive interface needs [`fzf`](https://github.com/junegunn/fzf#installation) **0.35 or
newer** — that is the release which added the `start` event agsearch binds. Some distributions
package an older one; `fzf`'s own install script is the fallback. Without fzf,
`agsearch -n "query"` still prints ranked matches.

### Install script

Expand Down
3 changes: 2 additions & 1 deletion agsearch
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1334,7 +1334,8 @@ def cmd_filter(argv):
def run_fzf(lines, query, thinking=False, no_resume=False, fuzzy=False):
if not shutil.which("fzf"):
print("fzf not installed. Falling back to non-interactive output.\n"
"Install with: brew install fzf\n", file=sys.stderr)
"Install fzf 0.35+: https://github.com/junegunn/fzf#installation\n",
file=sys.stderr)
return print_matches(lines, query)

self = os.path.abspath(__file__)
Expand Down
2 changes: 1 addition & 1 deletion install.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ esac

if ! command -v fzf >/dev/null 2>&1; then
echo "note: fzf is not installed — the interactive TUI needs it."
echo " macOS: brew install fzf · Linux: see https://github.com/junegunn/fzf"
echo " fzf 0.35 or newer: https://github.com/junegunn/fzf#installation"
echo " (agsearch -n \"query\" works without fzf)"
fi

Expand Down