vercel-labs

fx: Run a Native Coding Agent in Your Terminal

fx is a minimal, embeddable coding-agent CLI built in Zig as a single native binary for macOS and Linux. Use it interactively, from scripts and CI, or embed its agent core in JavaScript apps through libfx.

NewZigApache-2.0AI AgentsCLITerminal
Stars
3.7k
Forks
424
Stars, last 30 days
+420
Last commit
today
Contributors
31

Our take

Newless than six months old and changing fast

Health score

56/100

How it is scored
Activity
77
Community
38
Issues
46
Pull requests
64

+420 stars in the last 30 days

  • Merges more pull requests than 94% of the projects we track

fx is a capable, unusually embeddable terminal agent, but its experimental status and strong contributor concentration make it a fast-moving project to evaluate before relying on it in production.

Good fit if

  • You want a native Zig CLI for macOS or Linux that can run interactively or from scripts.
  • You need ACP integration or want to embed the agent in a JavaScript application through libfx.
  • You are comfortable evaluating a young project that has been changing quickly, with frequent releases and substantial recent development activity.

Look elsewhere if

  • You need a mature project with development responsibility distributed across contributors. Although the project has 31 contributors, most code contributions are concentrated with one person.
  • Your team needs a project with a demonstrated record of closing issues; recent issue closure activity is limited in the supplied health data.
  • You need a stable WebAssembly integration, which the project explicitly describes as experimental.
All health signals
Last commit2026-11-03 (today)
Commits, last 90 days100+
Releases, last 12 months16 (latest v0.0.16, 2026-10-29)
Contributors31 (top contributor: 94% of commits)
Issues closed, last 90 days1+
Pull requests merged, last 90 days92 (typically merged in 1 day)
Project age3 months

Checked on 2026-11-03 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

3,889

Forks

448

Change since Nov 16, 2026: +14 stars·+3 forks

Overview

fx is a minimal coding-agent CLI built in Zig as a single native binary, with no runtime to install. It runs on macOS and Linux on x86_64 and arm64, and presents conversations as ordinary terminal output rather than replacing the screen with an IDE-style interface.

The project is designed to work both as a command-line agent and as an embeddable agent core. Developers can call it from scripts or CI with fx ask, connect editors through the Agent Client Protocol (ACP), or use libfx from JavaScript. Its built-in tools and extension points make it useful for automating coding tasks while keeping the interaction close to a Unix shell.

Key Features

  • Runs as a single native Zig binary, with builds for macOS and Linux on x86_64 and arm64.
  • Provides an interactive terminal agent and fx ask for one-shot requests, including structured JSON output for scripts.
  • Reads and edits files, runs shell commands, searches the web, reads URLs, and can delegate work to subagents.
  • Supports editor integrations through an Agent Client Protocol server over stdio.
  • Exposes the agent core to JavaScript apps through libfx, with native Node.js and experimental WebAssembly builds.
  • Adds project context through AGENTS.md, skills, and MCP servers.
  • Saves sessions locally and supports resuming conversations and looking up older context.
  • Offers permission modes, including an automatic mode with checks for actions outside routine project work.

Use Cases

  • A developer who wants a terminal-based agent to edit a project and run its tests without moving into a full-screen IDE interface.
  • A team adding coding-agent requests to shell scripts or CI jobs, where fx ask --json can provide structured output.
  • An editor or tool author integrating an agent through ACP rather than building an agent loop from scratch.
  • A JavaScript developer embedding the agent core or terminal in an application using libfx.
  • A project using AGENTS.md, skills, or MCP servers to provide coding instructions and tools to the agent.

What you need

Detected in the repository

  • Zig (main language on GitHub)
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install with:

curl -fsSL https://fx.sh/setup.sh | bash

Then sign in with fx login and run fx in a project directory. See the README and manual for setup, configuration, and command details.

Alternatives

  • openinterpreter: Open Interpreter is Rust-based and targets low-cost models, with support for multiple agent harnesses and ACP-compatible editors.
  • tau: Tau is a Python teaching project with a reusable event-driven core and session preservation.
  • zero: Zero is written in Go and emphasizes support for hosted or local models, local sessions, and explicit side-effect controls.
  • oh-my-pi: oh-my-pi is a TypeScript-based, IDE-aware agent with built-in code tools, subagents, and an embeddable SDK.
ProjectLanguageLicenseStarsStatus
fxZigApache-2.03.7kNew
openinterpreterRustApache-2.068.5kActive
tauPythonMIT3kNew
zeroGoMIT1.7kNew
oh-my-piTypeScriptMIT36.2kActive

Considerations

The repository is marked New and describes fx as experimental. It has seen rapid development and frequent releases, but code contributions are highly concentrated with one contributor. The supplied health data also shows little recent issue closure activity, so teams should assess how they will handle bugs and maintenance needs. WebAssembly support is experimental; the README does not identify a required runtime, Docker setup, or database.

Found this useful?

Share it with someone who would like fx.

Comparisons