Skip to content
Fish Config

open-url

Terminal window
open-url [-s|--silent] [-v|--verbose] <url>
           open-url -h | --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). Pass –verbose / -v to report which browser is launched; –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)
Terminal window
open-url https://git.rootiest.dev/rootiest/fish-config
open-url -v https://fish-config-docs.pages.dev/

Used internally by config-help –html.

Typo abbreviation: url-open (expands to open-url on space/enter).