CLI Reference

The fused CLI lets you manage Fused from your terminal — run UDFs, manage canvases and files, handle secrets, and connect integrations. It ships with the fused Python package and needs Python 3.10 or newer.

Install

Install it with uv, which puts fused on your PATH and picks a compatible Python for you:

uv tool install fused

Or install it with pip in a Python 3.10+ environment:

pip install --upgrade "fused>=2"

Run fused --help to check the install. To upgrade later, run uv tool upgrade fused or rerun the pip command.

warning

On Python 3.9, pip install fused installs fused 1.x, which has no fused command, so your shell reports command not found: fused. The "fused>=2" pin makes pip fail with an error instead. Run python3 --version to check: the python3 that ships with macOS is 3.9.

Global flags

These flags apply to every command:

Flag	Env var	Description
--env TEXT	FUSED_ENV	Override the Fused environment: dev, stg, prod, unstable, or a deployment URL.
--format [json|text]	FUSED_CLI_FORMAT	Output format for command results (json or text).

Commands

Command	Description
fused beta	Discover the fused.beta methods published by the Fused team.
fused canvas	Manage canvases.
fused checkpoint	Manage canvas checkpoints.
fused claude	Manage Fused for Claude Code (via the claude CLI).
fused codex	Manage Fused for Codex (via the codex CLI).
fused completion	Print or install shell tab completion for the fused CLI.
fused copilot	Manage Fused for GitHub Copilot CLI (via the copilot CLI).
fused cronjob	Manage scheduled UDF runs.
fused files	Manage files stored in Fused.
fused integrations	Manage third-party integrations in Fused.
fused json-ui	Inspect and run JSON-UI widgets.
fused login	Authenticate and persist credentials.
fused logout	Log out and clear local credentials.
fused run	Run a UDF and print the result.
fused secrets	Manage kernel and user secrets.
fused udf	Search and manage UDFs.
fused udf-schema	Print the API schema for a UDF.
fused whoami	Show info about the authenticated user or team.