fx
| Name | Last commit date |
|---|---|
| .github | |
| benchmarks | |
| docker | |
| evals | |
| sdk | |
| src | |
| tests | |
| .gitignore | |
| AGENTS.md | |
| build.zig | |
| build.zig.zon | |
| CHANGELOG.md | |
| CONTRIBUTING.md | |
| LICENSE | |
| README.md |
⠀⠀⠀⠀⠀⠀⣠⣾⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⢰⣿⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⣠⣶⣿⣿⣷⣶⡶⣶⣶⣆⠀⠀⠀⣴⣶⣶⠆
⠀⠀⠀⠉⢹⣿⣿⠉⠉⠀⠘⢿⣿⣧⣀⣾⣿⡿⠃⠀ Tiny, open, embeddable, native coding agent.
⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⠻⣿⣿⣿⠟⠀⠀⠀
⠀⠀⠀⢀⣿⣿⠃⠀⠀⠀⠀⢠⣦⠘⢿⣿⣷⡀⠀⠀ curl -fsSL https://fx.sh/setup.sh | bash
⠀⠀⠀⣸⣿⡟⠀⠀⠀⠀⣰⣿⣿⠗⠀⠻⣿⣿⣄⠀
⠀⠀⠀⣿⣿⠇⠀⠀⠀⠾⠿⠿⠋⠀⠀⠀⠘⠿⠿⠦ ⚠ Status: Experimental. Use at your own risk.
⠀⣸⣿⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⣿⣿⣿⠟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
fx is a coding agent harness and CLI written in Zig, optimized for research and embeddability as part of larger systems.
It focuses on minimalism and performance across the board, from system prompt design to its tools, feature set, and 7.8 MiB binary.
For end users, its CLI output style and form factor aim to be closer to a Unix shell than a heavy "IDE in the terminal" TUI.
It's open source (Apache-2.0), model-agnostic, and suitable for both local and cloud inference.
Install
curl -fsSL https://fx.sh/setup.sh | bash
Run fx
To get started, sign in with Vercel:
fx login
Or add an AI Gateway API key:
fx setup
Run fx from a project:
cd your_project
fx
The current directory becomes the primary workspace. Enter a prompt, or run /help to browse interactive commands.
Run /feedback to copy a Markdown diagnostic and show a terminal link to a prefilled GitHub Issue Form. Paste the report into the form, then review and redact any sensitive data before submitting.
Use fx ask for a single request:
fx ask "explain the changes in this repository"
fx starts in auto permission mode, which reviews unresolved sensitive actions. See Permissions for other modes and persistent rules.
Embed fx
fx builds as a native binary or WebAssembly. Applications embedding fx can provide network transport, session storage, configuration, permission handling, and terminal I/O.
| Surface | Use |
|---|---|
fx acp |
Connect the native agent to editors and other Agent Client Protocol clients. |
createFxAgent() |
Embed the agent core in a JavaScript host with fx-core.wasm. |
createFxTerminal() |
Embed the interactive terminal with fx-term.wasm. |
The WebAssembly SDK is experimental. See the WebAssembly SDK and ACP documentation.
Extend fx
Add reusable instructions with skills, connect external tools through MCP, or delegate independent work to subagents.
Documentation
Read the fx documentation.
Build from source
Building fx requires Zig 0.16.0+:
git clone https://github.com/vercel-labs/fx.git
cd fx
zig build -Doptimize=ReleaseSafe
./zig-out/bin/fx
Run the test suite with zig build test. See CONTRIBUTING.md for development and contribution guidelines.