↓ Skip to main content
tomrochette.com
  1. Agents/

fx

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 5 minutes read (~857 words)
agent-curated 173 coding-agents 30 embedding 1 fully-ai-generated 263 harnesses 25 llm=glm-5.3-flash 178 research-note 148 vercel 2 zig 1
Table of Contents

fx is Vercel Labs’ coding agent harness and CLI written in Zig, built to be embedded in larger systems rather than to be your full development environment. Facts below verified as of 2026-09-13.

fx is the first credible entrant built on the bet that the harness wants to be a dependency, not an environment: a ~6 MiB Apache-2.0 binary with a microsecond cold start made to live inside other programs, sandboxes, and the browser.

What it is
#

A single Zig binary (6.17 MiB per the site) that does no unnecessary I/O before accepting input (the v0.0.8 release notes measure CLI startup at about 0.5 ms), with a CLI form factor pitched closer to a Unix shell than an IDE-in-the-terminal TUI. It is open source (Apache-2.0), model-agnostic, and compiles to WebAssembly, which is how the site runs the whole agent in a browser demo. Feature surface: native AGENTS.md loading (global, workspace, and per-directory), MCP, Claude-format skills directories (.claude/skills/ and peers), subagents as persistent child sessions with durable message queues, web search, vision, and an fx acp server so ACP-speaking editors can host it.

Status
#

Active and very young. The repository was created August 11, 2026 and shows 2,909 stars and 327 forks as of 2026-09-13, with v0.0.9 the latest release (published September 12, 2026; subagents can now run their own models and take mid-task feedback, and ! in the composer became plain prompt text) and pushes landing on 2026-09-13 (GitHub API). The launch thread drew 318 points on August 18, 2026 (HN). The README carries its own banner: “Status: Experimental. Use at your own risk.”

Strengths
#

  • Embeddability is the actual product: Node SDK, WebAssembly SDK, and browser integration for putting an agent inside sandboxes, CI, and other tools, which no mainstream harness treats as the primary use case.
  • The tiny binary and instant cold start make it the natural choice for resource-constrained environments and programmatic driving.
  • Reads AGENTS.md natively and consumes the Claude, Codex, OpenCode, and Claw skill directories, so it drops into existing conventions rather than inventing its own.
  • Subscription reuse without token exposure: ChatGPT via Codex OAuth and Grok via xAI OAuth, with sessions stored locally and never sent to Vercel (docs).

Cautions
#

  • Open source does not mean vendor-neutral: the default credential is Vercel AI Gateway, so the default path keeps Vercel on the meter and the metadata even when you self-host the binary; per the docs, Codex and Grok subscription requests go directly to their providers (usage docs).
  • v0.0.x with frequent changes promised; the site’s own demo page says “use at your own risk, we will be making frequent changes”.
  • The models and authentication docs still document only three credentials (Vercel AI Gateway, Codex, or Grok), but the site’s home page now advertises local models, gateways, and direct provider API access, so treat local-model and provider-key support as announced but not yet documented.
  • No hooks or plugins mechanism; skills only.
  • The pipe-to-shell installer (curl ... | bash) is the default install path; the docs themselves ask you to read the installation page first.

Pricing
#

The software is free under Apache-2.0. You pay for tokens through one of three credentials: your Vercel account’s AI Gateway billing, an AI Gateway API key, or an existing ChatGPT/Grok subscription via OAuth. There is no fx-specific subscription.

Compared to
#

  • OpenCode: the MIT full-environment harness with local models and any provider; pick OpenCode as your daily driver, fx when you need an agent inside something you are building.
  • goose: the other subscription-reuse story, but as a full Rust agent platform rather than an embeddable minimal binary.
  • Crush: the other small single-binary agent, but terminal-first rather than embed-first.

Bottom line
#

I would reach for fx when the agent is a component of my system (a sandbox, a pipeline, a product), and stay on OpenCode or a platform harness when the agent is where I work. Not for anyone who needs local models, provider-key BYOK, or a stable release line today.

Changes
#

  • 2026-08-29 - Created in the Harnesses category through the new-entrant scan, with a harness matrix column added the same day.
  • 2026-09-09 - Rewrote the credentials caution as announced-but-undocumented after the home page began advertising local models, gateways, and direct provider keys.
  • 2026-09-12 - Updated for v0.0.9’s reasoning steering and subagent delegation, and rewrote the vendor-routing caution as Codex and Grok requests now go direct.

See also
#

References
#