CLI reference

Run commands as npx fimo@latest <command> so you use the current CLI without a global install. The tables use fimo <command> for brevity. Run fimo --help for the full surface and fimo <command> --help for every argument and flag. Project-scoped commands target the current Git Branch. Use --branch <name> to override it for one command; the removed --env <name> selector is rejected. Other global options include --json, --no-color, and --ascii. Some commands add their own output flags.

Paginated lists

Paginated list commands share three flags:

fimo <list-command> --limit 20
fimo <list-command> --limit 20 --cursor <next-cursor>
fimo <list-command> --all-pages

--limit sets the page size. When more results exist, the command returns a nextCursor or prints an exact continuation command using --cursor. Use --all-pages when you intentionally need every remaining result. The older --before, --offset, and schedule --all spellings remain accepted as compatibility aliases, but new scripts should use the shared flags.

Projects & onboarding

Command	What it does
`fimo init [dir]`	Create a new Next.js App Router project by default.
`fimo init [dir] --framework react-router`	Create a new React Router project explicitly.
`fimo init [dir] --framework astro`	Create a minimal content-backed Astro project.
`fimo init [dir] --framework nextjs`	Create a minimal Next.js App Router project.
`fimo init [dir] --framework sveltekit`	Create a minimal SvelteKit project.
`fimo init --project-id <id>`	Link and clone an existing project.
`fimo clone [projectId] [dir]`	Clone an existing project locally.
`fimo link [projectId]`	Adopt the application in the current folder, in place.
`fimo projects list`	List projects in an org.
`fimo projects create [dir]`	Create a project through the `init` flow.
`fimo projects clone [projectId] [dir]`	Clone a project.
`fimo projects delete [projectId]`	Delete a project.
`fimo projects publish [projectId]`	Publish a project.
`fimo projects unpublish [projectId]`	Take a project offline.
`fimo projects rename <name> [projectId]`	Set a project’s display name.
`fimo projects transfer [projectId]`	Move a project to an organization you administer.
`fimo rename "<name>"`	Set the site/dashboard name; commit and deploy to apply it.
`fimo unpublish`	Take the project offline.
`fimo delete`	Delete the current project.
`fimo validate`	Run all checks + codegen.
`fimo update <version>`	Update the project’s Fimo packages to an exact release.

Migration

Command	What it does
`fimo migrate init <dir> --project-id <id>`	Prepare a migration target in an existing project.
`fimo migrate init <dir> --org <orgId>`	Create a new project and prepare it as the migration target.

fimo migrate init only sets the target up: it creates or links the project, scaffolds it, and pushes the first commit. It never reads the source site. Your coding agent reads the source and does the rebuild. Website migration is still in development. See Migrate an existing site for what to provide and the review it needs.

Migration flags

Flag	What it does
`-C, --cwd <dir>`	Use an existing project directory instead of the `<dir>` argument.
`--project-id <projectId>`	Link an existing project.
`--org <organizationId>`	Select the organization for a new project.
`--source-platform <platform>`	Say where the site comes from: `webflow`, `framer`, `squarespace`, `wix`, `carrd`, `wordpress`, `nextjs`, `astro`, `react-router`, or `other`.
`--framework <framework>`	Select the target project framework.
`--template-root <path>`	Override the project template directory.
`--install`, `--no-install`	Control dependency installation.
`--agents <list>`	Select coding agents when creating a project.
`-a, --agent <id>`	Add one coding agent. Repeat for more than one.
`--mode <mode>`	Select `symlink` or `copy` for installed skills.
`--json`	Print the setup receipt as structured output.

Account & organizations

Command	What it does
`fimo login`	Sign in via browser.
`fimo logout`	Revoke the session, clear credentials.
`fimo whoami`	Show the signed-in user + active org.
`fimo orgs list`	List orgs you belong to.
`fimo orgs members`	List members of an org.
`fimo orgs switch`	Change the active organization.
`fimo credits`	Inspect the org’s AI credit balance (read-only).
`fimo referral link`	Print your referral link.
`fimo referral stats`	Show your referral statistics.

Support

Command	What it does
`fimo support report "<message>"`	Submit a project-scoped report to Fimo’s internal support queue; it does not open a Pylon ticket.

Content

Command	What it does
`fimo schemas push [TypeName]`	Create/update schemas (omit name to push all).
`fimo schemas list`	List registered schemas.
`fimo schemas get <TypeName>`	Get a single schema.
`fimo schemas delete <TypeName>`	Delete a schema.
`fimo entries create <TypeName> --body '<json>'`	Create an entry.
`fimo entries list <TypeName>`	Query paginated entries (`--where`, `--sort`, `--fields`, `--populate`, …).
`fimo entries get <TypeName> <id>`	Get an entry.
`fimo entries update <TypeName> <id> --body '<json>'`	Update an entry.
`fimo entries delete <TypeName> <id>`	Delete an entry.
`fimo entries query --sql '<select>'`	Run read-only SQL over the entries table.
`fimo entries bulk-create <TypeName>`	Create entries from a JSON array.
`fimo entries bulk-update <TypeName>`	Update entries by IDs, filter, file, or stdin.
`fimo entries bulk-delete <TypeName>`	Delete entries by IDs or filter.
`fimo singles get <TypeName>`	Get a single content value.
`fimo singles update <TypeName> --body '<json>'`	Update a single content value.

See Content and schemas for the content workflow.

Forms

Command	What it does
`fimo forms push [formName]`	Push form JSON (patches `id` back).
`fimo forms list`	List registered forms.
`fimo forms get <id>`	Get a single form.
`fimo forms delete <id>`	Delete a form.
`fimo forms submissions list <formIdOrName>`	List paginated submissions (newest first).
`fimo forms submissions get <formIdOrName> <submissionId>`	Get one submission.
`fimo forms submissions stats <formIdOrName>`	Submission stats.

Media

Command	What it does
`fimo assets upload <path>`	Upload a file to the library.
`fimo assets bulk-upload <path>`	Upload files from a directory.
`fimo assets list`	Browse the paginated library (filters + search).
`fimo assets read <id>`	Read supported asset content for an agent.
`fimo assets open <id>`	Print metadata / `--download` / `--browser`.
`fimo assets create-folder <name>`	Create a media folder.
`fimo assets move <id> --parent-id <folder>`	Move an asset into a folder.
`fimo assets usage <id>`	Check Current, Main, and Live reference impact.
`fimo assets replace <id> --with <id>`	Replace Current Branch structured references.
`fimo assets remove <id>`	Safely remove from the current Branch.
`fimo assets remove <id> --permanent`	Confirm project-wide destruction.
`fimo image generate`	Generate an image from a prompt.
`fimo image edit`	Edit one or more images from an instruction.
`fimo image remove-background`	Create a transparent cutout.
`fimo image upscale`	Increase image resolution.
`fimo video generate`	Generate video from text or an image.
`fimo video animate`	Transfer motion from a video to an image.
`fimo video replace`	Replace people in a video.

Labels

Command	What it does
`fimo labels set <key> --value <v>`	Create/update one label.
`fimo labels set-many --data '<json>'`	Bulk set labels (`--file` also works).
`fimo labels list`	Inspect labels in the DB.
`fimo labels delete <key>`	Delete a label.
`fimo validate`	Verify every `t()` key has a DB value.

Locales

Command	What it does
`fimo locales list`	List configured locales and content coverage.
`fimo locales add <locale>`	Add a locale to the current Branch.
`fimo locales set-default <locale>`	Set the current Branch’s default locale.
`fimo locales remove <locale>`	Remove a locale and permanently delete its stored content.

Deploy & publish

Command	What it does
`fimo deploy [-m "<msg>"]`	On-demand hosted preview / shareable link.
`fimo deploy --publish`	Publish from the configured Production source.
`fimo deploy --no-restart`	Skip restarting the hosted Preview development server.
`fimo preview url`	Show the Branch’s hosted preview URL (no push).
`fimo publish`	Publish the revision on the Fimo remote; no push.
`fimo publish list`	List paginated publication attempts.
`fimo publish inspect <publicationId>`	Inspect one publication attempt.
`fimo publish logs <publicationId>`	Read one publication’s build log.
`fimo logs`	Read paginated project logs.

See Deploy and publish for the workflow.

Branches

Command	What it does
`fimo branch [<name>]`	List or create Branches (`-d` deletes).
`fimo checkout [-b] <name>`	Switch Branches; your app follows the git branch (`-b` creates + switches).
`fimo switch <name>`	Switch to an existing Branch.
`fimo pull`	Sync the current Branch’s data from its parent.
`fimo diff [from] [to]`	Compare two Branches across all surfaces.
`fimo status`	Multi-surface status vs the parent Branch.
`fimo merge <from>`	Merge another Branch in.
`fimo history list`	List paginated restore points.
`fimo history show <versionId>`	Show one restore point.
`fimo history create <name>`	Create a restore point.
`fimo history restore <versionId>`	Restore a recorded version.

Environments

Environments group Branches for deployment. They are a different concept from a Branch: Production and Preview are built in, and a custom Environment claims Branches by name or pattern.

Command	What it does
`fimo environments list`	List built-in and custom Environments.
`fimo environments create <name>`	Create a custom Environment.
`fimo environments update <name-or-id>`	Update a custom Environment.
`fimo environments delete <name-or-id>`	Delete a custom Environment.

Project variables & secrets

Command	What it does
`fimo vars list`	List public variables for the current Environment.
`fimo vars add <key> <value>`	Create a variable in the current Environment.
`fimo vars update <key> <value>`	Update a variable in the current Environment.
`fimo vars unset <key>`	Remove a variable from the current Environment.
`fimo vars pull [file]`	Write public variables to an env file.
`fimo secrets list`	List masked secrets for the current Environment.
`fimo secrets add <key> --stdin`	Create a secret in the current Environment.
`fimo secrets update <key> --stdin`	Rotate a secret in the current Environment.
`fimo secrets unset <key>`	Remove a secret from the current Environment.

Variables are public by design and may use browser-safe prefixes such as VITE_, PUBLIC_, or NEXT_PUBLIC_. Secrets are hidden after they are written, never reach the browser bundle or generated files, and cannot use those prefixes. There is no private-variable mode: if leaking a value would be a problem, use fimo secrets. fimo vars writes into a managed block in .env.local so local development picks the value up immediately, and fimo vars pull refreshes it later. See Secrets for the Studio side, and use --help before changing stored values.

Integrations

Command	What it does
`fimo integrations list`	List integrations available to the current project.
`fimo integrations info <key>`	Show auth modes, tools, effects, and recipes.
`fimo integrations status <key>`	Show an integration’s current state.
`fimo integrations connect <key>`	Connect an OAuth account or a user-owned server token.
`fimo integrations enable <key>`	Enable an integration for the current project.
`fimo integrations disable <key>`	Disable an integration for the current project.
`fimo integrations run <key> <tool> --input '<json>'`	Run any provider-defined tool with inline JSON.
`fimo integrations run <key> <tool> --input @request.json`	Read provider input from a project-relative JSON file.
`fimo integrations run <key> <tool> --input -`	Read provider input from stdin.
`fimo integrations auth use <key> <mode>`	Select an enabled integration’s authentication mode.

Firecrawl and Fal are built into Fimo. Fimo owns the provider account and bills the project in Fimo credits, so fimo integrations enable <key> is their whole setup and connect is refused for them. To use your own provider account instead, add that provider’s MCP server with fimo mcp add. Provider-defined tools and inputs can change. Run fimo integrations info <key> before invoking one.

Remote MCP servers

Command	What it does
`fimo mcp add <name> --url <https-url>`	Add and enable a remote MCP server.
`fimo mcp reconnect <server>`	Authorize an OAuth MCP connection again.
`fimo mcp rotate <server> --headers-stdin`	Replace a server’s complete private-header bundle.
`fimo mcp list`	List remote MCP servers for the current project.
`fimo mcp search <query>`	Search their live tool names and descriptions.
`fimo mcp info <server>`	Inspect one server and its live tools.
`fimo mcp run <server> <tool> --input '<json>'`	Run a remote tool with inline JSON.
`fimo mcp run <server> <tool> --input @request.json`	Read tool input from a project-relative JSON file.

Use fimo mcp <command> --help for the connection and input flags. See MCP for the setup workflow.

Domains

Command	What it does
`fimo domains list`	Default URL + custom domains.
`fimo domains rename-default <slug>`	Rename the default `fimo.site` slug.
`fimo domains suggest-default`	Propose & claim a default URL.
`fimo domains add <hostname>`	Attach a custom domain (Pay as you go+).
`fimo domains refresh <hostname>`	Re-check DNS / SSL.
`fimo domains remove <hostname>`	Detach a custom domain.
`fimo domains search <keyword>`	Find domains to buy.
`fimo domains pricing <domain>`	Show registration and renewal prices.
`fimo domains buy <domain>`	Create a purchase checkout invoice.
`fimo domains owned`	List domains bought through Fimo.

Analytics

Command	What it does
`fimo analytics pageviews`	KPIs, series, and top breakdowns.
`fimo analytics top <dimension>`	Top pages/browsers/devices/countries/sources.
`fimo analytics annotations set <date> "<note>"`	Annotate the chart.
`fimo analytics annotations list`	List annotations.
`fimo analytics annotations delete <date>`	Delete an annotation.

Scheduled agents

Command	What it does
`fimo agents create <name>`	Scaffold an agent bundle from a template.
`fimo agents list`	List agent bundles in the project.
`fimo agents list-templates`	List available agent templates.
`fimo agents validate [name]`	Validate a bundle.
`fimo agents integrations <name>`	Inspect an agent bundle’s integration needs.
`fimo agents run <name>`	Trigger a manual run; exits non-zero when credits are insufficient.
`fimo agents runs <name>`	List paginated run sessions with per-run credits.
`fimo agents report <name> [--details]`	Print a run’s report brief, or its evidence too.
`fimo agents secrets list <name>`	List secret names requested by an agent.
`fimo agents secrets add <name> <key>`	Add a requested agent secret.
`fimo agents secrets remove <name> <key>`	Remove a requested agent secret.
`fimo schedules create <name> --cron "<expr>" --do "<cmd>"`	Schedule a recurring command.
`fimo schedules list`	List schedules for the current Branch.
`fimo schedules show <schedule>`	Show configuration, usage, and policy.
`fimo schedules update <schedule> [options]`	Update cron, command, name, or selected secrets.
`fimo schedules pause <schedule>`	Pause future cron runs.
`fimo schedules resume <schedule>`	Resume future cron runs.
`fimo schedules run <schedule> [--no-wait]`	Queue a run now and optionally wait.
`fimo schedules runs <schedule> [options]`	List cursor-paginated run history.
`fimo schedules runs show <run-id>`	Show run detail and retained output.
`fimo schedules delete <schedule>`	Delete a schedule.

Inbox

Command	What it does
`fimo inbox list`	List notifications, unread first.
`fimo inbox list --topic agent_question --unread`	Show only the questions still waiting on an answer.
`fimo inbox get <notification-id>`	Show one notification, with the stored form when it asks one.
`fimo inbox answer <notification-id> --body '<json>'`	Answer the question and continue the run that asked it.

See Review and Inbox for the answer format and the rules a coding agent must follow before submitting one.

Collaboration

Command	What it does
`fimo invite --email <e> --role <r>`	Invite to the current project.
`fimo invite --target organization --email <e>`	Invite to the organization.

Pages

Command	What it does
`fimo pages list`	List registered site pages.
`fimo pages set <id>`	Create or update a page record.
`fimo pages rename <id> <new-id>`	Rename a page record.
`fimo pages delete <id>`	Delete a page record.

Webhooks

Command	What it does
`fimo webhooks events [eventType]`	List events or inspect one event.
`fimo webhooks list`	List project webhooks.
`fimo webhooks get <webhookId>`	Show a webhook.
`fimo webhooks create <name>`	Create a webhook.
`fimo webhooks update <webhookId>`	Update a webhook.
`fimo webhooks delete <webhookId>`	Delete a webhook.
`fimo webhooks test <webhookId>`	Send a test delivery.
`fimo webhooks deliveries <webhookId>`	List paginated deliveries.
`fimo webhooks delivery <webhookId> <deliveryId>`	Show a delivery and its attempts.
`fimo webhooks retry <webhookId> <deliveryId>`	Retry a failed delivery.
`fimo webhooks rotate-secret <webhookId>`	Rotate the signing secret.

Skills & rules

Command	What it does
`fimo skills install`	Install the global `fimo` skill for your AI tools.
`fimo skills list`	List the skills the CLI can serve on demand.
`fimo skills get <name>`	Print a skill’s content (add `--ref <doc>` for a reference).
`fimo skills sync`	Re-ensure the global skill; clean up skills from old versions.
`fimo skills uninstall`	Remove the global `fimo` skill.
`fimo rules sync`	Regenerate missing per-agent rule files.

Utilities

Command	What it does
`fimo describe [path]`	Describe the linked project or a project path.
`fimo validate`	Run project validation and code generation.
`fimo support report`	Prepare and send a report to Fimo support.

Start

Build your site

Preview and launch

Agents and automation

Work with your team

Migrate an existing site

Reference

CLI reference

Paginated lists

Projects & onboarding

Migration

Migration flags

Account & organizations

Support

Content

Forms

Media

Labels

Locales

Deploy & publish

Branches

Environments

Project variables & secrets

Integrations

Remote MCP servers

Domains

Analytics

Scheduled agents

Inbox

Collaboration

Pages

Webhooks

Skills & rules

Utilities

​Paginated lists

​Projects & onboarding

​Migration

​Migration flags

​Account & organizations

​Support

​Content

​Forms

​Media

​Labels

​Locales

​Deploy & publish

​Branches

​Environments

​Project variables & secrets

​Integrations

​Remote MCP servers

​Domains

​Analytics

​Scheduled agents

​Inbox

​Collaboration

​Pages

​Webhooks

​Skills & rules

​Utilities

Paginated lists

Projects & onboarding

Migration

Migration flags

Account & organizations

Support

Content

Forms

Media

Labels

Locales

Deploy & publish

Branches

Environments

Project variables & secrets

Integrations

Remote MCP servers

Domains

Analytics

Scheduled agents

Inbox

Collaboration

Pages

Webhooks

Skills & rules

Utilities