fw command reference
fw is one binary. fw --help lists the commands and fw <command> --help shows the usage of one. This section has a page for each of the 64 commands, read from those outputs (fw 2026.11.0).
Global options
Section titled “Global options”These options work with every command.
| Option | Meaning |
|---|---|
-C, --directory <DIR> |
Change working directory before running [env: FW_WORKING_DIR] |
--config <FILE> |
Path to config file [env: FW_CONFIG] |
--offline |
Disable network access [env: FW_OFFLINE] |
--json |
Emit machine-readable JSON output |
--color <WHEN> |
Color output: auto, always, never |
-q, --quiet |
Reduce output verbosity |
-v, --verbose |
Increase output verbosity |
-c |
Resume latest interactive session (when no command given) |
-h, --help |
Print help (or fw <command> --help) |
-V, --version |
Print version and exit |
Agent & Interactive
Section titled “Agent & Interactive”| Command | Aliases | What it does |
|---|---|---|
fw ask |
chat |
Run the multi-turn coding agent with tool calls (–model –url –resume –full-access –json) |
fw tool |
x |
Execute a workspace tool directly (read_file, write_file, edit_file, glob_files, grep_files, shell) |
fw tui |
m3-tui, god |
Launch interactive Material 3 TUI |
fw serve |
s |
Serve the chat web UI plus /v1/chat/completions, /mcp, /acp, /a2a and /webgpu |
Files & Media
Section titled “Files & Media”| Command | Aliases | What it does |
|---|---|---|
fw convert |
cv |
Convert a file into other files: video to SVG frames, Markdown, HTML, JSX and GPUI source (runs fw-video) |
fw google |
Google Workspace and YouTube: Drive list/export, Sheets get/update, Gmail list/draft (never sends), Calendar events, Docs text, YouTube channels/videos/playlists and video update behind –apply (runs fw-google) | |
fw files |
fl |
File manager engine from yazi: sorted listings, MIME and previewer rules, previews, copy/move/remove with progress events, sftp:// paths; JSON lines (runs fw-files) |
ML, Inference & Heretic
Section titled “ML, Inference & Heretic”| Command | Aliases | What it does |
|---|---|---|
fw infer |
run |
Send a prompt to an OpenAI-compatible endpoint; with –gguf, read the GGUF header and run a Q8_0 dot-product sample (no token generation) |
fw train |
finetune, lora |
LoRA SGD demo on a synthetic 32-dim layer; a dataset.jsonl is validated and counted, not trained on; writes an fw-lora-v1 JSON |
fw hf |
huggingface |
Hugging Face Hub client: search, info, files, pull, safetensors header and tokenizer.json inspection |
fw abliterate |
abl |
Abliteration: plan sizes a 7-step pipeline; biprojected, ara, sweep and moe run reference math on synthetic vectors, not model weights |
fw vram |
Estimate llama.cpp VRAM, SWA KV cache and the -ngl layer split | |
fw heretic |
Heretic TOML preset inspector; abliterate runs directional orthogonalization on synthetic vectors |
|
fw align |
dpo, orpo |
DPO, ORPO and KTO loss demo on one synthetic preference pair; no model is aligned |
Workspace & Protocols
Section titled “Workspace & Protocols”| Command | Aliases | What it does |
|---|---|---|
fw repomap |
Repository symbol map (Rust, TS/JS, Python, Go, Kotlin) | |
fw watch |
Manage persistent scheduled agent watchers (~/.fx/watchers.json) | |
fw tune |
cachy |
CachyOS hardware, sysctl, scx_lavd and ananicy-cpp profiles; x86-64-v3 and mimalloc microbenchmarks |
fw sec |
deepsec |
Pattern-based scan for secrets and risky code |
fw cluster |
Inference router (KV-cache affinity, prefill/decode split) over the sample topology, or a Kubernetes cluster through kube-rs (runs fw-k8s) | |
fw depot |
gclient |
depot_tools in Rust for Chromium and AOSP: gclient sync/revinfo/getdep/setdep, CIPD, fetch, autoninja, git cl and Gerrit, presubmit, repo manifests, lunch (runs fw-depot) |
fw kernel |
linux |
The Linux kernel as pinned files: kernel.toml pins (mainline, stable, CachyOS) against kernel.org releases, shallow sparse submodule sync, UAPI types for bun:ffi, tree-sitter code graph (runs fw-linux) |
fw graph |
graphify |
Code graph of a tree (tree-sitter Rust, oxc TS/JS, Markdown): calls, imports, communities, god nodes; runs fw-graph |
fw mem |
memory, claude-mem |
Memory store: add, then search (BM25), timeline and get; monthly JSONL shards |
fw docs |
c7, context7 |
Resolve and query library docs from crates.io, npm, PyPI, GitHub and llms.txt, cached locally |
fw corpus |
Polite incremental corpus of Google design, Android, Chromium, GitHub, Kotlin, Rust and Cargo docs in per-source SQLite FTS5 stores; fw learn search includes it |
|
fw site |
Docs site: write the MDX pages of apps/docs from code (fw –help, MCP tools, crates, products, releases), check them for drift, write llms.txt (runs fw-site) | |
fw learn |
autolearn |
Harvest git history, the code graph and docs into a local corpus; search all three; systemd prints a unit for a VPS |
fw skills |
List, read and install SKILL.md skills | |
fw onboard |
init-agent |
Describe the workspace for agents and export MCP, OpenCode and Zed configs |
fw workflow |
wf |
Run a built-in workflow (discover, abliterate-e2e, pkg-audit, perf-check) |
fw self-install |
Install fw binary into ~/.local/bin with SHA-256 verification | |
fw self-update |
update, upgrade |
Update from GitHub Releases, verify SHA-256, keep the previous binary as .prev |
fw self-uninstall |
Remove the fw binary (–purge-data also removes ~/.fx) | |
fw config |
Read or update ~/.fx/config.json | |
fw mcp |
Serve fw’s tools as an MCP server over stdio, or manage client MCP servers in ~/.fx/mcp.json | |
fw acp |
Run Agent Client Protocol JSON-RPC 2.0 server over stdio | |
fw sessions |
session |
List, inspect, or delete saved agent sessions |
fw permissions |
View or set agent permission mode | |
fw models |
provider |
List configured LLM providers & endpoints |
fw workspace |
Show git state and the file index | |
fw pr |
issue |
Read-only git status and diff snapshot |
fw doctor |
Check the toolchain, FX_HOME, git, API keys and Ollama on :11434 | |
fw completion |
Generate shell completion script | |
fw bench |
Run local compute, exec or HTTP benchmarks; perf run is the monorepo build, size, startup, link, wasm, Workers and GPU harness |
|
fw help |
Show help for fw or one command |
GNU/Linux & Wasm Userland
Section titled “GNU/Linux & Wasm Userland”| Command | Aliases | What it does |
|---|---|---|
fw sh |
In-process pipeline shell over 40 built-in applets, no child processes | |
fw jq |
JSON query filter (.a.b[0], keys, length) | |
fw tokei |
Lines-of-code counter by language | |
fw du |
Disk usage by directory | |
fw bat |
Line-numbered file viewer |
Packages & Dependencies
Section titled “Packages & Dependencies”| Command | Aliases | What it does |
|---|---|---|
fw init |
Initialize a project manifest | |
fw install |
i |
Install project dependencies |
fw add |
a |
Add a dependency to the project |
fw remove |
rm, uninstall |
Remove a dependency from the project |
fw lock |
Generate deterministic fw-pm.lock.json (Cargo + npm + APM) | |
fw verify |
Verify fw-pm.lock.json against workspace manifests | |
fw crates |
crate |
Crate intelligence over crates.io: ranked search, per-crate score, side-by-side comparison, per-category awesome lists, load-tested framework benchmarks, a stack and project-skeleton generator, and the daily dump sync (runs fw-crates) |
fw info |
resolve |
Fetch crates.io sparse index or npm registry metadata |
fw fetch |
download |
Download a .crate or npm .tgz into ~/.fw/cache and verify its SHA-256 |
fw tree |
scan |
Inspect workspace dependency graph (Cargo + npm + APM) |
fw export |
sbom |
Export CycloneDX 1.5 SBOM |
fw audit |
Audit installed dependencies | |
fw compile |
Compile APM instructions & targets | |
fw semver |
Evaluate Bun-compatible semver range |