Skip to main content

CLI Reference

The fused CLI lets you manage every part of Fused from your terminal — run UDFs, push and pull canvases, upload files, manage secrets, and connect third-party integrations.

Installation

pip install --upgrade fused

To run without a global install:

uvx fused <command>

Or inside a project venv:

uv run fused <command>

Authentication

fused login     # open browser OAuth flow, persist credentials
fused logout # clear credentials
fused whoami # show your user info
fused whoami --team # show your team info

Global flags

These flags apply to every command:

FlagEnv varDescription
--env TEXTFUSED_ENVOverride the Fused environment
--format [json|text]FUSED_CLI_FORMATOutput format — use json for machine-readable output in scripts
fused canvas list --format json
FUSED_CLI_FORMAT=json fused canvas list
note

The fused package also installs the Python SDK for use in scripts and notebooks. See Python installation for SDK-specific setup, authentication, and dependency options.

Commands

CommandDescription
fused canvasManage canvases — list, pull, push, share, serve as MCP
fused runRun a UDF and print the result
fused filesManage files stored in Fused
fused secretsManage kernel and user secrets
fused integrationsManage third-party OAuth integrations
fused json-uiInspect and debug JSON-UI widget configs
fused udf-schemaPrint the API schema for a UDF
fused claudeManage the Fused plugin for Claude Code