fluxGitHub →

The best coding agent, for you.

Minimal by design, extensible by default. One small binary, zero ceremony — bring your own model, drop in your own tools and skills, and get to work in seconds.

macOS · Linux · click to copyother install options →
flux
Flux 0.0.3
Press / for options
› 
Idle | ~/Documents/Code/flux-website (main)
Model: minimax/minimax-m2.7 (OpenRouter)
Tokens: 0↑ / 0↓ (0) | $0.0000
Context: 0.00% (of 196608)

// features

Built for people who live in a shell.

No tab-switching, no mouse, no Electron bloat. flux pairs a real TUI with a real tool-calling agent.

~/projects/api — flux
Flux 0.0.3
Press / for options
›implement /api/auth/logout 
↑↓ navigate
⏎ submit
/ commands
esc cancel
Idle | ~/projects/api (main)
Model: anthropic/claude-sonnet-4.6

// tui

Terminal-first

A keyboard-driven TUI built on tuix. No browser, no Electron, no mouse — every interaction is a keystroke. Slash commands, model switcher, file diffs, and a live status bar all live in your shell.

model picker
Select model:
  openai/gpt-5.5
›anthropic/claude-sonnet-4.6200k · $3/M
  anthropic/claude-haiku-4.5
  minimax/minimax-m2.7
  deepseek/deepseek-v3.2
  qwen/qwen3-coder-flash
↑↓ navigate · ⏎ select · esc cancel

// providers

Multi-provider, your keys

OpenRouter, OpenAI, and Anthropic out of the box, plus every model your providers expose. Switch on the fly with the model picker, or wire keys into ~/.flux/credentials.toml and forget about it.

tool execution
●Mapping the request lifecycle for /api/auth/logout
file_read: src/auth/session.go · 216 lines
file_read: src/auth/middleware.go · 89 lines
code_search: "validateSession(" · 6 matches
bash: go vet ./src/auth/... PASS
4 tools · 1.2s · ran in parallel

// tools

Real tools, in parallel

file_read, file_write, code_search, bash, file_search — flux uses real tools against your workspace, and runs independent calls in parallel when it's safe. No make-believe filesystem, no sandboxed snapshots.

subagent · code_explorer
●Spawning subagent_code_explorer
task: "map the request lifecycle for /api/messages"
◐ exploring src/handlers/
◑ exploring src/middleware/
● mapping handlers → middleware → db
→ returned: 11 files, 4 layers, report.md
subagent · 3.4s · 4,182 tokens

// subagents

Sub-agents for focus

Spawn code_explorer to survey a codebase, or bug_investigator to chase a regression — each runs in its own fresh context window and returns a structured report, so the main agent stays clean.

skill · code-review
›/review
●Invoking skill: code-review
→ reading 3 changed files
→ running golangci-lint
→ composing structured review
✓ no blocking issues
✓ 2 nitpicks (see below)
⚠ coverage on session.go dropped 4%
skill: code-review · 2.1s

// skills

Reusable skills

Skills are parameterised prompt templates registered as slash commands. /review, /init, /security-review — drop a markdown file in ~/.flux/skills/ and it's invokable everywhere, by the agent or by you.

ci · flux --yolo
$ flux --yolo --model anthropic/claude-sonnet-4.6 \ --max-turns 8 "bump dep versions and run tests"
●Reading package.json and lockfile
file_write: package.json +5 −5
bash: npm install · 204 packages updated
bash: npm test · 172 passed
✓ Done in 47s · 12,408 tokens · $0.03

// headless

Headless, for CI

Same engine, no UI. Run flux --yolo --max-turns N "do the thing" in a workflow step and let it operate non-interactively. Perfect for nightly bump-deps, doc-sync, or anything else you'd otherwise hand-script.

// install

One line. No build step.

The installer detects your OS and arch, drops a signed flux binary on your PATH, and you're ready to go.

macOS · Linux · click to copyinspect the script →
  1. 01
    Install

    Pipe the installer to sh. Single static binary, no toolchain needed.

  2. 02
    Add a key

    Export OPENROUTER_API_KEY, OPENAI_API_KEY, or ANTHROPIC_API_KEY.

  3. 03
    Run it

    flux from any project, or flux --yolo for headless runs.

// models

Pick any model. Swap on the fly.

flux ships with a provider registry and a model switcher in the UI. Defaults to minimax/minimax-m2.5.

+ every model your provider exposes
openai/gpt-5.2openai/gpt-5.5anthropic/claude-sonnet-4.6anthropic/claude-haiku-4.5minimax/minimax-m2.5minimax/minimax-m2.7deepseek/deepseek-v3.2qwen/qwen3-coder-flashmeta-llama/llama-3.3-70b-instruct

Stop tab-switching.
Start shipping from the shell.

or star on GitHub