Get started

Install the CLI

Install the stable release

$curl --proto '=https' --tlsv1.2 --fail --silent --show-error \
>  https://new.fp.dev/install.sh | sh
$fp2 --version

The installer:

  • selects macOS or Linux, x86-64 or ARM64, and GNU libc or musl;
  • authenticates the R2-hosted checksum using the pinned fp2 release key;
  • verifies the archive with SHA-256;
  • installs to ~/.local/bin by default.

It requires curl, tar, and openssl.

Customize installation

Set one of these environment variables before running the installer:

VariablePurpose
FP2_INSTALL_DIROverride the destination directory
FP2_VERSIONSelect an exact release
FP2_TARGETOverride automatic platform detection

Update an installed CLI

$fp2 update

Install an exact release only when a human deliberately selects it:

$fp2 update --version <version>

The update is atomic and verifies the same signed release channel. A CLI run directly from the source checkout cannot replace Bun and refuses to update.

Build from source

Inside the fp2 repository:

$bun install
$bun run apps/cli/src/index.ts --version

Source execution is for development. The signed standalone release is the recommended installed form.