1
Sign in
You do not need a global install:
- npm
- Bun
- pnpm
- Yarn
2
Set up the site on your machine
Pass the site ID. Studio shows it in the ready-made command; The command works whatever state the site is in. If the site already has code, it clones the repository into
fimo projects list prints it too.- npm
- Bun
- pnpm
- Yarn
my-site. If the site was created in Studio and never deployed, it scaffolds a fresh site into that folder and pushes the first commit. Either way it installs dependencies and offers to connect your coding agent.To start from a Branch other than main, add --branch <name>.Only members with manage access to the site can set it up locally. Ask a site admin for access if the command
is refused.
3
Run it
Move into the folder and start the framework’s own dev server with the package manager that matches the lockfile:There is no
- npm
- Bun
- pnpm
- Yarn
fimo dev: the site runs exactly as it would without Fimo, and connects to the site through .fimo/project.json and the active git branch.4
Work with your coding agent
The site ships with
AGENTS.md and CLAUDE.md, which point the agent at the Fimo instructions it needs. If you skipped the skills step during setup, or a teammate uses a different tool, follow Set up your coding agent.5
Push your work back
When a change is ready for review, deploy it to Preview:Fimo commits pending changes, pushes them, and returns Preview and Studio links. Publishing to production is a separate, deliberate step. See Deploy and publish.
- npm
- Bun
- pnpm
- Yarn
Code only, without installing
To fetch the repository and link the folder without installing dependencies, usefimo clone:
- npm
- Bun
- pnpm
- Yarn
fimo init --project-id as shown above, which scaffolds and pushes the first commit.
Already have the folder?
If the application is already on your machine and you want to connect it to a site without replacing its code, usefimo link from the folder. See Sites and onboarding.
What’s next
Set up your coding agent
Give the agent Fimo skills and the rules for this site.
Work in Branches
Propose changes in isolation and merge them when they are ready.
Deploy and publish
Move from a hosted Preview to production on your terms.