CLI

CLI reference.

Floom is terminal-first: run the CLI with npx -y @floomhq/floom, publish a skill, share the link, and add it with one command. Sync commands are preview.

npx -y @floomhq/floom

Run the Floom CLI from npm without a global install.

$ npx -y @floomhq/floom

npx -y @floomhq/floom login

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

$ npx -y @floomhq/floom login

npx -y @floomhq/floom publish <file>

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

$ npx -y @floomhq/floom publish pr-review-brief.md

npx -y @floomhq/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.

$ npx -y @floomhq/floom add https://floom.dev/s/ffas93ud --setup

npx -y @floomhq/floom sync

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

$ npx -y @floomhq/floom sync

npx -y @floomhq/floom watch

Preview — run sync repeatedly from the terminal.

$ npx -y @floomhq/floom watch --interval 60

npx -y @floomhq/floom list

List your published Floom skills.

$ npx -y @floomhq/floom list

npx -y @floomhq/floom library list

List public starter libraries.

$ npx -y @floomhq/floom library list

npx -y @floomhq/floom library create <slug>

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

$ npx -y @floomhq/floom library create team-onboarding --name "Team onboarding" --unlisted

npx -y @floomhq/floom library add <library> <skill>

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

$ npx -y @floomhq/floom library add team-onboarding support-tone --folder support/tone

npx -y @floomhq/floom move <slug>

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

$ npx -y @floomhq/floom move support-tone --folder support/tone

npx -y @floomhq/floom doctor

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

$ npx -y @floomhq/floom doctor