Unix like coding agent

★ 3,869⑂ 445👁 4⑃ 1,844● 190▤ 17
ZigApache-2.0Created 2026-08-11fx.sh
下载:v0.0.17v0.0.17 ↓0.0.172026-11-14
+27
日增长
+70
周增长
3,869
stars
445
forks
4
watchers
1,844
prs
190
issues
17
releases

README

⠀⠀⠀⠀⠀⠀⣠⣾⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀⠀
 ⠀⠀⠀⠀⠀⢰⣿⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
 ⠀⠀⠀⣠⣶⣿⣿⣷⣶⡶⣶⣶⣆⠀⠀⠀⣴⣶⣶⠆
 ⠀⠀⠀⠉⢹⣿⣿⠉⠉⠀⠘⢿⣿⣧⣀⣾⣿⡿⠃⠀             Tiny, open, embeddable, native coding agent.
 ⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⠻⣿⣿⣿⠟⠀⠀⠀
 ⠀⠀⠀⢀⣿⣿⠃⠀⠀⠀⠀⢠⣦⠘⢿⣿⣷⡀⠀⠀             curl -fsSL https://fx.sh/setup.sh | bash
 ⠀⠀⠀⣸⣿⡟⠀⠀⠀⠀⣰⣿⣿⠗⠀⠻⣿⣿⣄⠀
 ⠀⠀⠀⣿⣿⠇⠀⠀⠀⠾⠿⠿⠋⠀⠀⠀⠘⠿⠿⠦             ⚠ Status: Experimental. Use at your own risk.
  ⠀⣸⣿⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
 ⣿⣿⣿⠟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀


 fx

fx is a minimal coding agent CLI that still comes with batteries included. It's one native binary written in Zig, so there is no runtime to install, and it runs the same on your laptop, in CI, or inside an agent sandbox. Its output is closer to a Unix shell than an IDE, because the conversation prints into your terminal's scrollback instead of filling the screen.

fx is meant to be embedded and extended. Scripts call it with fx ask, editors connect over the Agent Client Protocol (ACP), and JavaScript apps run the same agent core through libfx with their own tools. Skills, MCP servers, and your project's AGENTS.md add to what the agent knows and can do.


  
  
  


 Features

- Small and fast: CI fails a pull request if any benchmarked command, such as fx help or fx status --json, takes longer than 2 ms on Linux (benchmarks). Stable releases for Apple silicon must also fit under a fixed size limit.
- Built-in tools: fx finds, reads, and edits files, runs shell commands, searches the web and reads URLs, and delegates work to subagents. A development server or file watcher can keep running while it works (tools).
- Model choice: sign in to Vercel AI Gateway, use a ChatGPT or Grok subscription, or connect an OpenAI-compatible Chat Completions endpoint such as Ollama or OpenRouter (custom model connections).
- Inline output: you can scroll, search, and copy the conversation like any other command's output, and tmux bindings and copy mode keep working. Terminals that support the Program Status Protocol can also show when fx is busy or waiting for you.
- Your own shell: commands run in your login shell, with your aliases, functions, and PATH. fx runs your startup files once and reuses the result until one of them changes, so a slow .zshrc doesn't slow down every command. Commands also receive AI_AGENT=fx in their environment, so development tools can detect fx.
- Permissions: the default auto mode runs routine work, such as editing project files and running tests, without asking. Anything else goes first to a model that checks the exact action for prompt injection or malicious behavior, and fx holds the action if the check finds a problem. Switch to ask to approve each action yourself, or to full-access to turn the checks off (permissions).
- Sessions: fx saves your conversations under ~/.fx/sessions/, and fx -c picks up where you left off in a project. When a conversation fills the model's context, fx compacts older turns but keeps their full text on disk, where the agent can look it up (sessions).

 Install

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


fx runs on 

Top issues

Latest release

v0.0.17 v0.0.17 2026-11-14
Subagents now work alongside you: switch between agents and run several fx instances in one window. Vercel Token Pass is now first-class in fx. Tool definitions 48.0% smaller, and 82.0% of later input from the prompt cache, up from 61.3%.

 New Features

- Subagents work alongside the main agent and report back when they finish.
- Switch to any subagent to watch it, message it, or answer its prompts.
- A parent agent hears when its subagent's command has printed nothing for 2 minutes.
- Open the agent list with Down or Ctrl+X to see, search, switch, and close agents.
- Each subagent has its ow

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON