# fx documentation

> Documentation for fx, the small, fast, native coding agent for the terminal.

Use the Markdown pages below for installation, configuration, workflows, and complete CLI reference.

## getting started

- [Quick start](https://fx.sh/docs.md): Install fx, run a first request, and learn the commands worth knowing.
- [Installation](https://fx.sh/docs/getting-started/installation.md): Install fx, review what the installer does, and verify the local binary.
- [Authentication](https://fx.sh/docs/getting-started/authentication.md): Choose how fx accesses AI models.
## using fx

- [Sessions](https://fx.sh/docs/using-fx/sessions.md): Save, resume, recover, compact, and inspect fx sessions.
- [fx ask](https://fx.sh/docs/using-fx/fx-ask.md): Run noninteractive requests, return JSON, and continue saved sessions.
- [CLI commands](https://fx.sh/docs/using-fx/cli.md): Reference for top-level fx commands and global flags.
- [Slash commands](https://fx.sh/docs/using-fx/slash-commands.md): Reference for commands inside the interactive shell.
- [Usage and costs](https://fx.sh/docs/using-fx/usage-and-costs.md): Inspect local token usage and AI Gateway balance.
- [ACP server](https://fx.sh/docs/using-fx/acp.md): Run fx from editors and clients that support Agent Client Protocol.
- [Troubleshooting](https://fx.sh/docs/using-fx/troubleshooting.md): Diagnose install, authentication, model, permission, session, and terminal problems.
- [Data and privacy](https://fx.sh/docs/using-fx/data-and-privacy.md): Understand model requests, AI Gateway controls, and local data.
- [Share feedback](https://fx.sh/docs/using-fx/share-feedback.md): Report an fx problem and collect private diagnostics for terminal issues.
## embedding fx

- [Embed fx](https://fx.sh/docs/lib.md): Choose whether to run fx through the native CLI, ACP server, or WebAssembly SDK.
- [WebAssembly SDK](https://fx.sh/docs/lib/webassembly.md): Run the WebAssembly build of fx as an interactive terminal or a headless agent.
- [Browser integration](https://fx.sh/docs/lib/host-integration.md): Connect the fx WebAssembly SDK to browser storage, authentication, commands, and network requests.
## configure fx

- [Models](https://fx.sh/docs/configure-fx/models.md): Choose the model used by fx.
- [Permissions](https://fx.sh/docs/configure-fx/permissions.md): Control tool execution with modes, rules, and session grants.
- [Project instructions](https://fx.sh/docs/configure-fx/project-instructions.md): Control fx with global, workspace, and target-scoped AGENTS.md files.
- [Configuration](https://fx.sh/docs/configure-fx/configuration.md): Complete reference for fx settings, scopes, defaults, and environment variables.
- [Additional workspaces](https://fx.sh/docs/configure-fx/additional-workspaces.md): Give fx access to additional directories while keeping one primary workspace.
- [Context limits](https://fx.sh/docs/configure-fx/context-limits.md): Configure byte limits for project instructions, skills, MCP metadata, and adapters.
## capabilities

- [Tools](https://fx.sh/docs/capabilities/tools.md): Built-in tools available to the fx agent.
- [Web search](https://fx.sh/docs/capabilities/web-search.md): Research current public information with source links.
- [Vision](https://fx.sh/docs/capabilities/vision.md): Understand how fx provides native vision and fallback image analysis.
- [Skills](https://fx.sh/docs/capabilities/skills.md): Discover, load, install, and create reusable agent instructions.
- [MCP](https://fx.sh/docs/capabilities/mcp.md): Add MCP servers to fx, authenticate them, and keep their configuration private.
- [MCP protocol reference](https://fx.sh/docs/capabilities/mcp/protocol.md): Transports, protocol coverage, schema handling, and isolation for the fx MCP client.
- [Subagents](https://fx.sh/docs/capabilities/subagents.md): Create and manage session-backed child agents.

## Complete documentation

- [All fx documentation in one file](https://fx.sh/llms-full.txt): Every documentation page combined for large-context agents.