Skip to main content

Drivers

A driver is the how of a pipeline stage — it describes one AI CLI tool and how fluxaOS invokes it. Where a skill defines what the AI should do, the driver defines which binary runs it, how to pass the prompt, and what output format to expect.

fluxaOS ships with a seeded Claude Code driver (binary: claude). You can add drivers for any AI CLI tool by configuring the fields below.

Key fields:

FieldPurpose
BinaryThe CLI command to invoke (e.g., claude, openai)
Prompt transportHow the prompt is delivered: stdin, argv, or file
Output formatHow to parse output: stream-json or text
Model flagCLI flag for selecting the model (e.g., --model)
Env varsEnvironment variables to inject at run time (e.g., API keys)
Context layoutWhich files to write to the workspace before the stage runs
Is enabledToggle — disabled drivers cannot be selected for new stages

Where to configure: Settings → Drivers → New Driver

For a step-by-step walkthrough, see Guide 01: First Setup.