FISH-LSP(1)

📦 version 1.1.5, in nixpkgs unstable

🎀 NAME 🎀

okay bestie, meet fish-lsp(1) — A language server for the fish shell 🐟💖 This is the manual for fish-lsp, and it's giving “your fish scripts are about to get main character energy” ✨

🌸 SYNOPSIS 🌸

fish-lsp [OPTIONS]
fish-lsp [SUBCOMMAND] [OPTIONS]

🦋 DESCRIPTION 🦋

fish-lsp is a language server for the fish shell. It brings IDE-like features to fish shell scripts, like syntax checking, linting, and auto-completion — yes bestie, all the good stuff 💅

It requires a language client that supports the Language Server Protocol (LSP). Some common language clients include: the builtin API for nvim (v0.9+), lsp-mode for emacs, or the fish-lsp extension for VSCode 🫶

The documentation below shows usage of the fish-lsp command, including its subcommands and options. Periodt.

bestie, this is not a standalone editor vibe — it needs an LSP client to actually do its thing. The manual said it, so I'm saying it too 💖

✨ OPTIONS ✨

  • -v, --version — Show version information and exit. 👋
  • -h, --help — Show help message and exit. 🫶
  • --help-all — Show all the help information ✨
  • --help-short — Show shortened help message 🌸
  • --help-man — Show manpage output 📖

💅 SUBCOMMANDS 💅

🚀 start

start the language server — the main event, the moment, the slay 💅

  • --enable — enable the language server features ✨
  • --disable — disable the language server features 🙈
  • --dump — dump the json output of the language server features enabled after startup 👀
  • --stdio — use stdin/stdout for communication (default) 🫶
  • --node-ipc — use node IPC for communication 🔌
  • --socket <port> — use TCP socket for communication 🌐
  • --memory-limit <mb> — set memory usage limit in MB 🧠
  • --max-files <number> — override the maximum number of files to analyze 📂
  • --web — start server in web mode used for https://fish-lsp.dev/playground 🌈

🍓 env

show the environment variables available to the lsp 🍓

  • -c, --create — create the environment variable ✨
  • -s, --show — show the environment variables 👀
  • --show-default — show the default values for fish-lsp env variables 🎀
  • --only <VAR> — only include the specified environment variables in the output 🎯
  • --no-global — don't use global scope when generating environment variables 🌍
  • --no-local — don't use local scope when generating environment variables 🏠
  • --no-export — don't use export flag when generating environment variables 🚫
  • --no-comments — skip outputting comments 💬
  • --confd — output for redirecting to conf.d/fish-lsp.fish 🐟
  • --json — output fish_lsp_* initialization variables as JSON object (for vscode settings.json) 🧾

🧚 info

show the build info of fish-lsp 🧚

  • --bin — show the path of the fish-lsp executable 🛠️
  • --path — show the path of the entire fish-lsp installation 📦
  • --build-time — show the path of the entire fish-lsp repo 🕰️
  • --build-type — show the build type of the command 🏷️
  • -v, --version — show the lsp version 💖
  • --lsp-version — show the vscode-languageserver version 🧩
  • --capabilities — show the lsp capabilities ✨
  • --man-file — show the man file path 📖
  • --log-file — show the log file path 🪵
  • --show — show the man/log file contents (needs to be paired with --log-file or --man-file) 👀
  • --short — display small amount of info (alias for --version --build-type --build-time --lsp-version) 🎀
  • --json — display the info as JSON (e.g., fish-lsp info --short --json) 🧾
  • --extra — show debugging server info (capabilities, paths, version, etc.) 🔍
  • --verbose — show debugging server info (capabilities, paths, version, etc.) 🗣️
  • --check-health — run diagnostics and report health status 🩺
  • --health-check — run diagnostics and report health status 💖
  • --time-startup — time the startup of the fish-lsp executable ⏱️
  • --time-only — show brief summary of the startup timing 🕰️
  • --use-workspace <PATH> — use the workspace at the specified directory path when fish-lsp info --time-startup is used 📁
  • --no-warning — disable message in the fish-lsp info --time-startup output 🚫
  • --show-files — show the files that were indexed during startup when fish-lsp info --time-startup is used 📂
  • --dump-symbol-tree <FILE> — show the fish-lsp definition symbol tree for the specified file 🌳
  • --dump-parse-tree <FILE> — show the tree-sitter AST for the specified file 🌲
  • --dump-semantic-tokens <FILE> — show the semantic-tokens for the specified file 🎨
  • --no-color — disable color output from --dump-* output 🌈
  • --no-icons — disable icon usage in output from fish-lsp info --dump-symbol-tree 🚫
  • --source-maps — show the source-maps 🗺️
  • --url — used with --source-maps, show the download url of the external source map for this version 🔗
  • --check — used in combination with --source-maps, verifies source-maps are working by throwing an error 💀
  • --status — used in combination with --source-maps, shows status of source-maps loading 📊

🦋 url

show a helpful url related to the fish-lsp 🦋

  • --repo, --git — show the github repo 🐙
  • --npm — show the npm package url 📦
  • --homepage — show the homepage 🏠
  • --contributions — show the contributions url 🤝
  • --wiki — show the github wiki 📚
  • --issues, --report — show the issues page 🐛
  • --discussions — show the discussions page 💬
  • --clients-repo — show the clients configuration repo 🧩
  • --sources — show a list of helpful sources 🔗

🌟 complete

Provide completions for the fish-lsp 🌟

  • --names — show the feature names of the completions 🏷️
  • --toggles — show the feature names of the completions 🎚️
  • --fish — show fish script 🐟
  • --features — show features ✨
  • --env-variables — show env variable completions 🍓
  • --env-variable-names — show env variable names 🏷️
  • --names-with-summary — show the names with the summary for the completions 📝
  • --abbreviations — show the 'fish-lsp' subcommand abbreviations 💅

🌈 EXAMPLES 🌈

  • Start the fish-lsp language server, with the default configuration:
>_ fish-lsp start
  • Generate the completions for the fish-lsp language server binary:
>_ fish-lsp complete > ~/.config/fish/completions/fish-lsp.fish
  • Debug the fish-lsp language server by dumping the enabled features after startup:
>_ fish-lsp start --dump
  • Show information about the fish-lsp language server:
>_ fish-lsp info
  • Show all the available information about the fish-lsp language server:
>_ fish-lsp info --verbose
  • Show startup timing information for the fish-lsp language server:
>_ fish-lsp info --time-startup
  • Show startup timing information for the fish-lsp language server for a specific workspace:
>_ fish-lsp info --time-startup --use-workspace ~/.config/fish --no-warning
  • Preform a health check on the fish-lsp language server:
>_ fish-lsp info --check-health
  • Show the tree-sitter-fish parse tree for the input:
>_ cat ~/.config/fish/config.fish | fish-lsp info --dump-parse-tree
  • Show the definition symbol tree for a specific file:
>_ fish-lsp info --dump-symbol-tree ~/.config/fish/config.fish
  • Show the semantic tokens for a specific file (read from stdin):
>_ cat $__fish_data_dir/config.fish | fish-lsp info --dump-semantic-tokens
  • Show the environment variables available to the fish-lsp language server:
>_ fish-lsp env --show
  • Show the default values for specific environment variables used by the fish-lsp language server:
>_ fish-lsp env --show-default --only fish_lsp_all_indexed_paths,fish_lsp_max_background_files --no-comments
  • Get sources related to the fish-lsp language server's development:
>_ fish-lsp url --sources

🫶 SEE ALSO 🫶

👑 AUTHOR 👑

  • Nick Donfris 👑

That's the tea 🍓: the source/manual tag is FISH-LSP(1), version 1.1.5, dated October 2026. Now go be iconic with your fish scripts, bestie 💅🐟✨

📦 where this page comes from