Skip to main content
The Fluid CLI is a command-line tool that brings your theme development workflow to your local machine. With it, you can pull your live theme down to edit in your preferred code editor, push changes back to the server, run a local development server with hot reload, and manage authentication across multiple company accounts. It is designed for developers who want full control over their theme files outside of the browser-based editor.

​
Installation

Install the Fluid CLI using either RubyGems or Homebrew:
After installation, verify it is available by running fluid --version.

​
Authentication

Before you can interact with any theme, you need to authenticate the CLI with your Fluid account.
This opens the Fluid authentication flow in your browser. After you approve access, the CLI stores a token locally for future commands. To check which account and company you are currently authenticated as:
To sign out and remove the stored token:

​
Company Management

If you manage multiple companies in Fluid, you can switch between them without logging out. Run the interactive company switcher:
Or switch directly to a specific company by subdomain:
After switching, all subsequent theme commands operate against the selected company’s theme.

​
Theme Commands

Use these commands to manage your theme files between your local machine and the Fluid platform.

​
Examples

Pull your current theme before making changes:
Push your local changes as a draft so you can preview before publishing:
Start the local dev server for active development:

​
Install theme skills

Install the bundled theme-development skills so a compatible coding agent can use them:
The default destination is .agents/skills/ in your current project. Existing skills remain untouched unless you approve the overwrite. Choose a different destination with --dir or -d:
Overwrite existing copies without a prompt with --force or -f:
Restart your agent session after installation so it can discover the new skills.

​
Getting Started Workflow

Follow these steps to go from a fresh install to an active local development environment:
1

Install the CLI

Install via RubyGems or Homebrew as shown above.
2

Log in

Run fluid login and complete the browser authentication flow.
3

Create a project directory

4

Initialize or pull your theme

To start a brand new theme:
Or, to download your existing published theme:
5

Start the development server

The dev server proxies requests to your local theme files, so you can see changes in the browser instantly as you save.
6

Push your changes

When you’re ready to publish:
Or push as a draft first to review in the admin:
fluid theme dev is currently only available when the CLI is installed via RubyGems (gem install fluid_cli). If you installed via Homebrew and need local dev server support, reinstall using the gem method.