Tiny, open, native coding agent.

curl -fsSL https://raw.githubusercontent.com/
afa7789/ffx/main/setup.sh | bash

v0.0.8 Zig status: experimental

ffx

𝒇𝒇x v0.0.8 · Run /help for commands

auto · kimi-k3

A coding agent written in Zig for your terminal. Open, embeddable, and free from mandatory Vercel login.

01 / providers

Use the models you already pay for.

ffx is a community fork of fx focused on provider freedom. Connect direct providers with your own credentials, or add any OpenAI-compatible, Anthropic, self-hosted, or custom endpoint.

OpenAI, Anthropic, DeepSeek, OpenRouter, PPQ, MiniMax, Zhipu/GLM, Z.AI, and OpenCode
Persistent configuration in ~/.ffx/settings.json
Dynamic provider tabs, model discovery, and favorites in /models
No mandatory Vercel account for direct providers

/connect-provider /switch-provider /models

02 / capabilities

A small runtime with room to grow.

Skills

Discover skills without loading every instruction into every prompt.

/skills
/skills show <name>
/skills install owner/repo --skill name

Subagents

Create one-off or persistent child sessions with their own model, permissions, and history.

ctrl+x  open subagent manager

MCP

Connect local and remote MCP servers while keeping project trust and permission boundaries explicit.

/mcp list
/mcp add <name> <command>
/mcp reload

Project instructions

Load scoped AGENTS.md guidance for workspace conventions, security, and verification.

project/
├── AGENTS.md
└── apps/web/AGENTS.md

03 / cli

Unix-like by design.

Run an interactive session in a workspace or make one request and exit.

ffx
ffx ask "explain the changes in this repository"
ffx sessions
ffx status --json

Inside a session, use /help to discover commands. The current directory is the primary workspace.

04 / try it

Build it. Run it. Make it yours.

git clone https://github.com/afa7789/ffx.git
cd ffx
zig build -Doptimize=ReleaseSafe
./zig-out/bin/ffx

Requires Zig 0.16 or newer. The binary is written to ./zig-out/bin/ffx.