1
Install the CLI and sign in
The
fimo CLI is published on npm. Run it with npx — always the latest, no global install.fimo login opens a browser loopback flow and captures the token automatically — nothing to copy or paste. fimo whoami shows the active user and organization; switch orgs with fimo orgs switch.2
Set up the project
Link an existing project (you have a project ID):Or create a brand-new project in an empty directory and follow the prompts:
fimo init is the single onboarding entry point — it signs you in if needed, creates or links the project, clones it locally, installs dependencies, and offers to set up skills and rule files for your AI tool. Pass -y to run non-interactively.3
Build against a local dev server
Your iteration loop is local. Start the dev server with the project’s package manager (match the lockfile), then work with your agent — edit, see the change live, repeat.You do not need to deploy to see local changes. Your agent uses schemas, entries, forms,
t() labels, and media through the fimo CLI and the project skill.4
Deploy a hosted preview
When a unit of work looks done, deploy an on-demand preview to get a shareable, hosted link:This commits pending changes, pushes, syncs the preview sandbox, and prints a preview URL. Just need the current URL again? Use
fimo preview url — no redeploy.5
Publish to production
When you’re ready to go live, publish from Your site is served at
main:<slug>.fimo.site by default. Rename it or attach a custom domain from the Custom domains page.What’s next
Core concepts
The mental model behind projects, environments, content, and agents.
Build with the CLI
Schemas, entries, forms, media, and labels through
fimo.Deploy & publish
Previews, publishing, and markdown for AI agents.