https://github.com/fish-shell/fish-shell Skip to content Toggle navigation Sign up * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Resources + Customer Stories + White papers, Ebooks, Webinars + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. {{ message }} fish-shell / fish-shell Public * Notifications * Fork 1.7k * Star 22.1k The user-friendly command line shell. fishshell.com License View license 22.1k stars 1.7k forks Activity Star Notifications * Code * Issues 446 * Pull requests 12 * Discussions * Actions * Projects 1 * Wiki * Security * Insights More * Code * Issues * Pull requests * Discussions * Actions * Projects * Wiki * Security * Insights fish-shell/fish-shell This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. master Switch branches/tags [ ] Branches Tags Could not load branches Nothing to show {{ refName }} default View all branches Could not load tags Nothing to show {{ refName }} default View all tags Name already in use A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch? Cancel Create 31 branches 75 tags Code * Local * Codespaces * Clone HTTPS GitHub CLI [https://github.com/f] Use Git or checkout with SVN using the web URL. [gh repo clone fish-s] Work fast with our official CLI. Learn more about the CLI. * Open with GitHub Desktop * Download ZIP Sign In Required Please sign in to use Codespaces. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching Xcode If nothing happens, download Xcode and try again. Launching Visual Studio Code Your codespace will open once ready. There was a problem preparing your codespace, please try again. Latest commit @yuntaz0 yuntaz0 Improve completion for rpm-ostree (#9910) ... 9d0d166 Aug 26, 2023 Improve completion for rpm-ostree (#9910) * Some temporary change until compose - commit * First draft * Fix an error that prints double completion * Fix completion errors. Add rpm-ostree alias. Fix cimpletion where it trigger by multiple commands. Add update and remove, which are aliases for upgrade and uninstall. * Remove -r when it is unnecessary Some command need path completion for arguments no matter what, which makes -r flag useless * Remove -x for compose image -x does not block the path anyway * Add missing short otpion in compose image Revert the last change to block -l completion * Fix description Fix multiple description. 9d0d166 Git stats * 17,558 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time .builds fish.spec/.builds: drop SHOW_INTERACTIVE_LOG June 8, 2022 18:37 .github Make CI use the workspace, so we format/check all August 19, 2023 15:18 benchmarks Add more benchmarks June 1, 2023 18:15 build_tools style.fish: Add rustfmt support June 1, 2023 18:14 cmake Use the workspace from CMake August 19, 2023 15:18 debian fish.spec/Debian packaging: update licensing details May 25, 2023 22:23 doc_internal Add note to rust devel about the wchar builtin August 9, 2023 15:00 doc_src fish_key_reader: Humanize key descriptions August 26, 2023 10:43 docker Add Dockerfiles for ARM64 and ARMv7 November 12, 2022 15:20 etc Update /etc/config.fish to use current syntax May 8, 2020 15:20 fish-rust Also allow command and in a pipeline August 26, 2023 13:45 osx Add the get-task-allow entitlement February 29, 2020 15:29 po fixed a few smaller things in my translations June 3, 2023 14:03 share Improve completion for rpm-ostree (#9910) August 26, 2023 15:05 src parse_execution: Remove dead tcgetattr code August 26, 2023 14:58 tests fish_key_reader: Humanize key descriptions August 26, 2023 10:43 .cirrus.yml Update Cirrus CI FreeBSD runner to 13.2-RELEASE May 23, 2023 12:17 .clang-format Ensure that clang-format places config.h first in header list October 13, 2019 15:45 .clang-tidy .clang_tidy: turn off cert-dcl21-cpp, add some others. September 24, 2021 09:30 .editorconfig In .editorconfig replace max_line_length: none with off. July 31, 2023 09:18 .gitattributes .gitattributes: rig the count December 19, 2021 18:58 .gitignore gitignore: add clangd .cache directory March 5, 2023 14:04 .oclint Tell oclint to ignore another idiom that is safe September 9, 2017 00:18 BSDmakefile Preserve CMake options when make is invoked July 12, 2020 18:26 CHANGELOG.rst CHANGELOG: Document incompatible changes August 22, 2023 15:27 CMakeLists.txt Complete the transition of the kill ring and remove kill.cpp August 13, 2023 13:06 CODE_OF_CONDUCT.md Add code of conduct July 6, 2020 20:13 CONTRIBUTING.rst CONTRIBUTING: Improve translation section June 2, 2023 17:38 COPYING Licensing: note MIT licensing status of Dracula theme May 25, 2023 21:30 Cargo.lock Use a cargo workspace August 19, 2023 15:18 Cargo.toml Move edition and MSRV to workspace August 19, 2023 15:18 Dockerfile Update Dockerfile for cmake3 April 28, 2019 11:41 GNUmakefile GNUMakefile: remove redundant CMake arguments December 29, 2020 16:31 README.rst README: remove Xcode, minor linting August 4, 2023 22:28 config_cmake.h.in drop unused functions and configure checks July 14, 2023 20:48 fish.desktop Update fish.desktop (#8584) December 25, 2021 23:52 fish.pc.in Use pkg-config variables April 4, 2020 13:07 fish.png fish.png: use the same thing we ship with the docs October 16, 2021 14:12 fish.spec.in fish.spec/Debian packaging: update licensing details May 25, 2023 22:23 View code [ ] fish - the friendly interactive shell Quick Start Getting fish macOS Packages for Linux Windows Building from source Running fish Dependencies Switching to fish Building Dependencies Dependencies, git master Building from source (all platforms) - Makefile generator Build options Help, it didn't build! Contributing Changes to the Code Contact Us README.rst fish - the friendly interactive shell Build Status Cirrus CI Build Status fish is a smart and user-friendly command line shell for macOS, Linux, and the rest of the family. fish includes features like syntax highlighting, autosuggest-as-you-type, and fancy tab completions that just work, with no configuration required. For downloads, screenshots and more, go to https://fishshell.com/. Quick Start fish generally works like other shells, like bash or zsh. A few important differences can be found at https://fishshell.com/docs/ current/tutorial.html by searching for the magic phrase "unlike other shells". Detailed user documentation is available by running help within fish, and also at https://fishshell.com/docs/current/index.html Getting fish macOS fish can be installed: * using Homebrew: brew install fish * using MacPorts: sudo port install fish * using the installer from fishshell.com * as a standalone app from fishshell.com Note: The minimum supported macOS version is 10.10 "Yosemite". Packages for Linux Packages for Debian, Fedora, openSUSE, and Red Hat Enterprise Linux/ CentOS are available from the openSUSE Build Service. Packages for Ubuntu are available from the fish PPA, and can be installed using the following commands: sudo apt-add-repository ppa:fish-shell/release-3 sudo apt update sudo apt install fish Instructions for other distributions may be found at fishshell.com. Windows * On Windows 10, fish can be installed under the WSL Windows Subsystem for Linux with the instructions for the appropriate distribution listed above under "Packages for Linux", or from source with the instructions below. * Fish can also be installed on all versions of Windows using Cygwin (from the Shells category). Building from source If packages are not available for your platform, GPG-signed tarballs are available from fishshell.com and fish-shell on GitHub. See the Building section for instructions. Running fish Once installed, run fish from your current shell to try fish out! Dependencies Running fish requires: * curses or ncurses (preinstalled on most *nix systems) * some common *nix system utilities (currently mktemp), in addition to the basic POSIX utilities (cat, cut, dirname, ls, mkdir, mkfifo, rm, sort, tee, tr, uname and sed at least, but the full coreutils plus find and awk is preferred) * The gettext library, if compiled with translation support The following optional features also have specific requirements: * builtin commands that have the --help option or print usage messages require nroff or mandoc for display * automated completion generation from manual pages requires Python 3.5+ * the fish_config web configuration tool requires Python 3.5+ and a web browser * system clipboard integration (with the default Ctrl-V and Ctrl-X bindings) require either the xsel, xclip, wl-copy/wl-paste or pbcopy/pbpaste utilities * full completions for yarn and npm require the all-the-package-names NPM module * colorls is used, if installed, to add color when running ls on platforms that do not have color support (such as OpenBSD) Switching to fish If you wish to use fish as your default shell, use the following command: chsh -s /usr/local/bin/fish chsh will prompt you for your password and change your default shell. (Substitute /usr/local/bin/fish with whatever path fish was installed to, if it differs.) Log out, then log in again for the changes to take effect. Use the following command if fish isn't already added to /etc/shells to permit fish to be your login shell: echo /usr/local/bin/fish | sudo tee -a /etc/shells To switch your default shell back, you can run chsh -s /bin/bash (substituting /bin/bash with /bin/tcsh or /bin/zsh as appropriate). Building Dependencies Compiling fish from a tarball requires: * a C++11 compiler (g++ 4.8 or later, or clang 3.3 or later) * CMake (version 3.5 or later) * a curses implementation such as ncurses (headers and libraries) * PCRE2 (headers and libraries) - optional, this will be downloaded if missing * gettext (headers and libraries) - optional, for translation support Sphinx is also optionally required to build the documentation from a cloned git repository. Additionally, running the test suite requires Python 3.5+ and the pexpect package. Dependencies, git master Building from git master currently requires, in addition to the dependencies for a tarball: * Rust (version 1.67 or later) * libclang, even if you are compiling with GCC * an Internet connection fish is in the process of being ported to Rust, replacing all C++ code, and as such these dependencies are a bit awkward and in flux. In general, we would currently not recommend running from git master if you just want to use fish. Given the nature of the port, what is currently there is mostly a slower and buggier version of the last C++-based release. Building from source (all platforms) - Makefile generator To install into /usr/local, run: mkdir build; cd build cmake .. make sudo make install The install directory can be changed using the -DCMAKE_INSTALL_PREFIX parameter for cmake. Build options In addition to the normal CMake build options (like CMAKE_INSTALL_PREFIX), fish has some other options available to customize it. * BUILD_DOCS=ON|OFF - whether to build the documentation. This is automatically set to OFF when Sphinx isn't installed. * INSTALL_DOCS=ON|OFF - whether to install the docs. This is automatically set to on when BUILD_DOCS is or prebuilt documentation is available (like when building in-tree from a tarball). * FISH_USE_SYSTEM_PCRE2=ON|OFF - whether to use an installed pcre2. This is normally autodetected. * MAC_CODESIGN_ID=String|OFF - the codesign ID to use on Mac, or "OFF" to disable codesigning. * WITH_GETTEXT=ON|OFF - whether to build with gettext support for translations. Note that fish does not support static linking and will attempt to error out if it detects it. Help, it didn't build! If fish reports that it could not find curses, try installing a curses development package and build again. On Debian or Ubuntu you want: sudo apt install build-essential cmake ncurses-dev libncurses5-dev libpcre2-dev gettext On RedHat, CentOS, or Amazon EC2: sudo yum install ncurses-devel Contributing Changes to the Code See the Guide for Developers. Contact Us Questions, comments, rants and raves can be posted to the official fish mailing list at https://lists.sourceforge.net/lists/listinfo/ fish-users or join us on our gitter.im channel. Or use the fish tag on Unix & Linux Stackexchange. There is also a fish tag on Stackoverflow, but it is typically a poor fit. Found a bug? Have an awesome idea? Please open an issue. About The user-friendly command line shell. fishshell.com Topics shell fish terminal Resources Readme License View license Code of conduct Code of conduct Activity Stars 22.1k stars Watchers 283 watching Forks 1.7k forks Report repository Releases 39 fish 3.6.1 (released March 25, 2023) Latest Mar 25, 2023 + 38 releases Used by 5 * @masfahru * @seanpm2001 * @akirataguchi115 * @anas-stuff Contributors 805 * @ridiculousfish * @faho * @liljencrantz * @mqudsi * @zanchey * @krader1961 * @krobelus * @floam * @lilyball * @siteshwar * @ammgws + 794 contributors Languages * C++ 42.8% * Rust 31.8% * Shell 17.4% * Python 5.1% * CMake 1.2% * JavaScript 0.6% * Other 1.1% Footer (c) 2023 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time.