CLI

CLI reference.

Floom is terminal-first: install the CLI, publish a skill, share the link, add with floom add. Sync commands are preview.

npm install -g @floomhq/floom

Install the Floom CLI globally from npm.

$ npm install -g @floomhq/floom

floom login

Open browser OAuth and store your Floom token locally (`~/.floom/config.json`).

$ floom login

floom publish <file>

Upload Markdown knowledge, instructions, or a workflow and get a shareable skill link.

$ floom publish pr-review-brief.md

floom add <url-or-slug>

Add a link-accessible Floom skill into your local agent folder. No Floom account is required for public or unlisted links.

$ floom add https://floom.dev/s/ffas93ud

floom sync

Preview — sync your published, saved, and subscribed library skills into your local agent folder.

$ floom sync

floom watch

Preview — run sync repeatedly from the terminal.

$ floom watch --interval 60

floom list

List your published Floom skills.

$ floom list

floom library list

List public starter libraries.

$ floom library list

floom library create <slug>

Create a personal or starter library you can fill with skills.

$ floom library create team-onboarding --name "Team onboarding" --unlisted

floom library add <library> <skill>

Add a skill to a library and optionally place it in a folder.

$ floom library add team-onboarding support-tone --folder support/tone

floom move <slug>

Choose where a saved or subscribed skill lands in your local agent folder.

$ floom move support-tone --folder support/tone

floom doctor

Diagnose auth, target directory, add path, and CLI compatibility.

$ floom doctor

See also: getting started, publish guide, API reference.