Skip to content

Get started with fw

Each step is one action. Do them in order.

On Windows, open PowerShell. On Linux, open any terminal.

Follow the install page for your system. It takes one command.

Run this command.

Terminal window
fw --version

The output starts with fw 2026.11.0 or a newer number.

Terminal window
fw doctor

The command checks the toolchain, FX_HOME, git, API keys and Ollama on port 11434. Fix what it reports, then run it again.

Terminal window
cd path/to/your/project
Terminal window
fw onboard

The usage is fw onboard [dir] | fw onboard export <all|mcp|opencode|zed> [--dir <dir>]. The command describes the workspace for agents.

Terminal window
fw onboard export all

This writes .mcp.json, opencode.json and .zed/settings.json in the project. Open one and check that it lists the fw MCP server.

Terminal window
fw ask "what does this project do?"

The agent needs a model endpoint. Run fw models to see the configured providers.

Terminal window
fw serve 127.0.0.1:8787

The usage is fw serve [host:port]. Open http://127.0.0.1:8787/ in your browser to see the chat page. The server also answers on /mcp, /acp and /a2a: see the API reference.