CLI

The flue CLI ships in the @flue/cli package as a single flue binary. It scaffolds projects, runs one agent module locally, fetches integration blueprints, and reads the documentation bundled with your installed version.

The CLI is not the build tool. Dev servers and production builds are owned by Vite: vite dev and vite build, with the flue() plugin from @flue/vite in vite.config.ts.

Invocation

@flue/cli requires Node.js 22.19 or newer. flue init scaffolds it as a devDependency, and the getting started guide installs it alongside @flue/runtime:

npm install @flue/runtime @flue/cli

The flue bin is then available through your package manager’s runner (npx flue, pnpm flue, yarn flue) or from package.json scripts:

npx flue run src/agents/assistant.ts -m "Say hello"

Commands

• flue init [directory] — scaffold a starter Flue project, prompting for the build target and server setup when flags are omitted.
• flue run <path> — run one agent module locally without a server: submit one message, stream the turn, print the reply, exit.
• flue add [kind] [name|url] — fetch a blueprint implementation guide for a coding agent to follow; with no arguments, list the available blueprints.
• flue update <kind> <name|url> — fetch the same blueprint guide for updating an existing integration.
• flue docs [read|search] — list the bundled documentation pages, print one as markdown, or search them.

Each command page is the reference for that command’s arguments, flags, and output. Every command prints its primary payload to stdout and everything else — prompts, streaming output, errors — to stderr, so piping stdout is always safe.

Global flags

Flag	Description
--help, -h	Print usage to stdout and exit 0. Works globally and per command (flue run --help).
--version, -v	Print the @flue/cli version to stdout and exit 0.

There are no other global flags; every command rejects flags it does not declare.