Skip to content

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).

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
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
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)
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
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
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
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