@fluid-app/fluid-cli

The Fluid Commerce CLI. Provides authentication, profile management, and a plugin system for extending with domain-specific commands.

Installation

npm install -g @fluid-app/fluid-cli

Authentication

# Email MFA flow
fluid login

# API token (avoids shell history exposure)
FLUID_TOKEN=your-token-here fluid login

# Manage profiles
fluid whoami            # Show active profile
fluid switch            # Switch between profiles
fluid logout            # Remove stored authentication

Profiles are stored at ~/.fluid/config.json.

Plugins

Install plugins alongside the core CLI to add commands:

| Package | Commands | Description | | -------------------------------- | ------------------ | ------------------------------------ | | @fluid-app/fluid-cli-theme-dev | fluid theme * | Theme dev server, push, pull, init | | @fluid-app/fluid-cli-portal | fluid portal * | Portal app build, deploy, push, pull | | @fluid-app/fluid-cli-themes | fluid themes * | Theme management API commands | | @fluid-app/fluid-cli-assets | fluid assets * | Digital asset management commands | | @fluid-app/fluid-cli-droplets | fluid droplets * | Droplet management commands |

Example:

npm install -g @fluid-app/fluid-cli @fluid-app/fluid-cli-theme-dev
fluid theme dev

Plugins are auto-discovered from:

1. node_modules/@fluid-app/ in the current working directory
2. node_modules/@fluid-app/ where the CLI itself is installed (global installs)
3. Sibling packages in a pnpm workspace (monorepo development)

Environment Variables

| Variable | Description | | ------------------ | ------------------------------------------------ | | FLUID_TOKEN | API token (alternative to fluid login) | | FLUID_API_BASE | API base URL (default: https://api.fluid.app) | | FLUID_CONFIG_DIR | Override config directory (default: ~/.fluid/) |

Development

For contributors working in fluid-mono:

pnpm --filter @fluid-app/fluid-cli build
node packages/cli/core/dist/bin/fluid.mjs --help