1
Sign in
You do not need a global install:
2
Set up the project on your machine
Pass the project ID. Studio shows it in the ready-made command; The command works whatever state the project is in. If the project already has code, it clones the repository into
npx fimo@latest projects list prints it too.my-site. If the project 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 project can set it up locally. Ask a project 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:Use
npm run dev, yarn dev, or bun dev if the project uses that package manager instead. There is no fimo dev: the site runs exactly as it would without Fimo, and connects to the project through .fimo/project.json and the active git branch.4
Work with your coding agent
The project 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.
Code only, without installing
To fetch the repository and link the folder without installing dependencies, usefimo clone:
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 project without replacing its code, usefimo link from the folder. See Projects and onboarding.
What’s next
Set up your coding agent
Give the agent Fimo skills and the rules for this project.
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.