Flux Documentation
Flux is an AI coding agent that works in your terminal and uses the repository you open it from. It can explain code, edit files, run commands, and help with longer development tasks.
New to Flux? Follow the four-page path below. No need to to understand agents, tools, skills, or model settings before you begin.
#Get started
- Install Flux
- Connect a model provider
- Complete your first repository task
- Add instructions for your project
The Getting Started overview lists what you need and what you will learn at each step.
#Find what you need
| I want to… | Go to |
|---|---|
| Give Flux a specific file, document, or image | Files and context |
| Continue a previous conversation | Sessions and memory |
| Structure or redirect a larger task | Planning and steering |
| Run Flux from a script or CI job | Non-interactive and CI |
| Automate repeated work | Automation |
| Look up a command or setting | Reference |
| Diagnose a problem | Troubleshooting |
#Learn advanced workflows
After you are comfortable with the basics, use the guides for complete recipes involving subagents, skills, MCP, plugins, and long-running work. Use the features section when you want to understand an individual capability.
Workspace boundary: Flux treats the directory where you start it as the active workspace. Start at your repository root so it can see the whole project.