Installation

Depending on your system or preferences, use one of the following methods:

brew

brew install fx

snap

snap install fx

# The snap is strictly confined: it reads files under your home directory only.
# To open files on mounted drives (`/media`, `/mnt`, `/run/media`), connect the
# removable-media interface once:
# 
#     sudo snap connect fx:removable-media
# 
# For files elsewhere, such as `/etc` or `/var`, pipe them in:
# 
#     sudo cat /etc/foo.json | fx
# 
# ":w !cmd" runs inside the snap too, so it can't reach your shell or
# the tools installed on your system. Use another install method if you need it.

scoop

scoop install fx

pacman

pacman -S fx

pkg

pkg install fx

go

go install github.com/antonmedv/fx@latest

docker

docker run -it --rm -v .:/data:ro antonmedv/fx file.json

nix

nix-shell -p fx

Binary Download

Download the latest binary from the GitHub releases page. Or execute the following command:

curl https://fx.wtf/install.sh | sh

The install.sh script will download the appropriate binary for your system and install it to /usr/local/bin.

Installation on Windows

For Windows users: install Go and run the following command:

go install github.com/antonmedv/fx@latest

Autocomplete

To enable autocompletion, add the following line to your .bashrc or .zshrc:

bash

source <(fx --comp bash)

zsh

source <(fx --comp zsh)

fish

fx --comp fish | source

GitHub Actions

As GitHub Actions comes with a Node.js environment, you can use fx in your workflows via npx:

steps:
  - name: Bump version
    run: npx fx package.json 'x.version = x.version.replace(/\d+$/, n => +n + 1), x' save

The npm variant of fx is compact and doesn't need additional dependencies.

Node & Deno

npm

npm install -g fx

deno

deno install -A npm:fx

Note

Remember, the JavaScript version of fx operates only in a non-interactive mode. It offers JSON processing functionality only.