flux agent

Manage Flux agents.

Sub-commands

• flux agent create — Create an agent definition.
• flux agent delete — Delete an agent definition.
• flux agent list — List all agents.
• flux agent session — Manage agent sessions.
• flux agent show — Show agent definition.
• flux agent start — Start an agent in the specified mode.
• flux agent stop — Stop a running agent session.
• flux agent update — Update an agent definition.

flux agent create

Create an agent definition.

Arguments

• name (text, required)

Options

• --model, -m — Model in provider/model_name format (default: Sentinel.UNSET)
• --system-prompt, -s — System prompt text (default: Sentinel.UNSET)
• --system-prompt-file — Read system prompt from file (default: Sentinel.UNSET)
• --description, -d — Agent description (default: Sentinel.UNSET)
• --file, -f — YAML definition file (default: Sentinel.UNSET)
• --tools — Built-in tool names (repeatable) (default: Sentinel.UNSET)
• --tools-file — Python file with @task tools (default: Sentinel.UNSET)
• --workflow-file — Custom workflow file (default: Sentinel.UNSET)
• --mcp-server — MCP server URL (repeatable) (default: Sentinel.UNSET)
• --skills-dir — Skills directory (default: Sentinel.UNSET)
• --planning, --no-planning — Enable planning
• --max-tool-calls — Max tool call iterations (default: Sentinel.UNSET)
• --max-tokens — Max LLM response tokens (default: Sentinel.UNSET)
• --reasoning-effort — Reasoning depth (default: Sentinel.UNSET)
• --format, -F — (default: simple)
• --server-url — Flux server URL

flux agent delete

Delete an agent definition.

Arguments

• name (text, required)

Options

• --format, -f — (default: simple)
• --server-url — Flux server URL

flux agent list

List all agents.

Options

• --format, -f — (default: simple)
• --server-url — Flux server URL

flux agent session

Manage agent sessions.

flux agent show

Show agent definition.

Arguments

• name (text, required)

Options

• --format, -f — (default: yaml)
• --server-url — Flux server URL

flux agent start

Start an agent in the specified mode.

Arguments

• name (text, required)

Options

• --mode, -m — Serving mode (default: terminal)
• --session, -s — Attach to existing session (default: Sentinel.UNSET)
• --port, -p — Port for web/api mode (default: Sentinel.UNSET)
• --host — Host to bind web/api mode (default: 127.0.0.1; use 0.0.0.0 to expose externally) (default: 127.0.0.1)
• --server — Flux server URL (default: from config)
• --plain — Use plain ANSI terminal (no TUI)

flux agent stop

Stop a running agent session.

Arguments

• session_id (text, required)

flux agent update

Update an agent definition.

Arguments

• name (text, required)

Options

• --model, -m — Model in provider/model_name format (default: Sentinel.UNSET)
• --system-prompt, -s — System prompt text (default: Sentinel.UNSET)
• --system-prompt-file — Read system prompt from file (default: Sentinel.UNSET)
• --description, -d — Agent description (default: Sentinel.UNSET)
• --file, -f — YAML definition file (default: Sentinel.UNSET)
• --planning, --no-planning — Enable planning
• --max-tool-calls — Max tool call iterations (default: Sentinel.UNSET)
• --reasoning-effort — Reasoning depth (default: Sentinel.UNSET)
• --format, -F — (default: simple)
• --server-url — Flux server URL

Generated from flux/cli.py. Last verified against Flux 0.56.0.