Repository navigation
Install
curl -fsSL https://raw.githubusercontent.com/acamarata/findplus/main/install.sh | bashInstalls Find+ into ~/.local/share/findplus/ and links findplus into
~/.local/bin/. Requires Python 3.12, 3.13 or 3.14. Pass --yes to skip the
confirmation prompt, or --uninstall to remove it (see Uninstall
for what that keeps and what it removes).
~/.local/bin is not on the default PATH on macOS, and on Debian and Ubuntu
~/.profile adds it only if the directory already existed when you logged in.
If it is not on yours, the installer says so and prints the line to add; until
you add it, ~/.local/bin/findplus works by full path.
On Debian and Ubuntu the venv module ships separately from python3. If it
is missing the installer names the exact package to install
(sudo apt install python3.12-venv) rather than the Python version.
Re-running the installer upgrades an existing install. If its virtualenv was broken by an OS upgrade or a removed Python, re-running rebuilds it.
Find+ is not published to PyPI. Install the wheel from the latest release
instead. Download the findplus-<version>-py3-none-any.whl from the
Releases page (for example, v1.1.2):
pipx install https://github.com/acamarata/findplus/releases/download/v1.1.2/findplus-1.1.2-py3-none-any.whlOr install from the latest release directly:
gh release download --repo acamarata/findplus --pattern '*.whl' && pipx install findplus-*.whlpip install with the same URL works inside an existing virtualenv.
brew install acamarata/tap/findplusbrew upgrade findplus picks up each new release once the tap formula is updated.
Download FindPlus-<version>-aarch64.dmg from the
Releases page. Open the
dmg and drag Find+ to Applications. The app bundles the daemon, so no
separate CLI install is required.
The app is built for Apple Silicon only. On an Intel Mac, install with Homebrew or the curl installer above and open the dashboard in your browser at http://127.0.0.1:8647.
Run findplus setup for a guided walkthrough (or findplus auth then
findplus start for the two-command path), then continue with
First run.
To remove Find+ later, see Uninstall.