Installation
fx runs on macOS and Linux, on 64-bit Intel and ARM machines.
Install
curl -fsSL https://fx.sh/setup.sh | bashThe installer puts fx in ~/.local/bin. If that directory isn't on your PATH, the installer adds it to your shell's startup file: ~/.zshrc for zsh, ~/.bash_profile or ~/.bashrc for bash, or ~/.config/fish/config.fish for fish. Open a new terminal, then continue with Quick start.
Upgrade
While fx is open, it checks for updates in the background and installs them. When an update is installed, the footer in the lower-right shows update ready: ctrl+g to reload. Press ctrl+g while fx is idle and the composer is empty to restart on the new version and continue the current conversation. Otherwise, fx runs the new version the next time you start it.
To install an update now:
fx upgradefx update is an alias. After an update, fx shows a notes link to the release's entry in the changelog.
To turn off automatic updates, run fx config set auto_upgrade false, or set FX_AUTO_UPGRADE=0 in the environment. See Interface and update settings.
Use development releases
The dev channel follows changes merged into main after CI passes. Switch to it with:
fx upgrade --channel devfx remembers the channel for later updates. Its startup header shows the release version, short commit SHA, and [dev], such as v0.0.16-57eadd6 [dev].
After an update, fx links changes to the commits since your previous dev release. Return to stable with:
fx upgrade --channel stableOther install options
Install a specific release:
curl -fsSL https://fx.sh/setup.sh | bash -s -- <version>Use the release tag with its leading v, such as v0.0.15. Unless you turn off automatic updates, fx updates itself to the latest release the next time it checks.
To install somewhere else, pass FX_INSTALL_DIR to the installer. For example, to use ~/bin:
curl -fsSL https://fx.sh/setup.sh | FX_INSTALL_DIR="$HOME/bin" bashIf your terminal cannot find fx, open a new terminal or add its install directory to PATH:
export PATH="$HOME/.local/bin:$PATH"Run fx --version to check the installed version. For installation problems, see Troubleshooting.