Skip to content

open-url

Usage
open-url [-s|--silent] [-v|--verbose] <url>
open-url --help

Opens a URL (or file:// URI) in the best available graphical web browser, backgrounded so it never blocks the terminal. Resolves a real browser binary rather than deferring to xdg-open, whose MIME dispatch can hand local text/html files to non-browser apps (e.g. ebook readers).

Silent by default: prints nothing on success (errors always go to stderr); –silent / -s is accepted for explicitness.

Resolution order:
1. $fish_help_browser (explicit override)
2. $BROWSER (validated; errors if not a command)
3. xdg-mime default handler for x-scheme-handler/https
4. First known browser binary found in a built-in list
5. xdg-open (last resort)

Arguments:

url The URL or file:// URI to open (required)
-s, --silent Suppress success output (the default)
-v, --verbose Print which browser is being launched
-h, --help Print usage and exit

Returns:

0 Browser launched
1 No URL given, invalid $BROWSER, or no browser found
Notes:
Typo abbreviation: url-open (expands to open-url on space/enter).
Examples
open-url https://git.rootiest.dev/rootiest/fish-config
open-url -v https://fish-config-docs.pages.dev/

Used by: repo-open