homebrew-fx

Homebrew tap for fx - Vercel Labs' tiny, native coding agent.

Install

brew tap temikus/fx
brew install temikus/fx/fx

Or without tapping first:

brew install temikus/fx/fx

Recent Homebrew versions ask you to trust a third-party tap before installing from it:

brew trust temikus/fx

Heads up: name clash with homebrew-core

homebrew/core ships a different fx (the JSON viewer), and both install a binary called fx. If you have that one installed, unlink it first:

brew unlink fx
brew install temikus/fx/fx

Only one of them can own fx in your PATH at a time.

Usage

fx login   # sign in with Vercel AI Gateway
cd your_project
fx

See the upstream README for provider setup (Vercel AI Gateway, OpenAI Codex, xAI Grok) and configuration.

Maintenance

Requires just:

Command	What it does
just audit	brew audit --strict --online against the local formula
just install	Install from the local formula file
just test	Run the formula's test do block
just check	Install, test, and uninstall
just style	Lint the tap the way CI does - formula, workflows, and shell
just bump	Rewrite the formula for the latest upstream release
just verify-bump	Check bump.sh reproduces the pinned formula exactly

just bump pulls the newest release tag and the published .sha256 sidecar for each platform, so no manual checksum copying. CI re-runs it against the pinned tag on both Linux and macOS and fails if the formula drifts, which covers both the upstream release API and the GNU/BSD sed difference.

License

The tap is Apache-2.0. fx itself is Apache-2.0, licensed by Vercel Labs.