Projects & onboarding

fimo init is the single onboarding entry point — it signs you in, creates or links a project, clones it locally, installs dependencies, and can wire up skills and rule files for your AI tool. There’s no separate fimo install or fimo create.

Create or link a project

fimo init                              # create a NEW project (interactive)
fimo init --project-id <id>            # link an EXISTING project (clones it)
fimo init my-site --org <id>           # name the directory + target org (use the org id)

Common flags:

Flag	Purpose
`--project-id <id>`	Link an existing project instead of creating one.
`--org <id>`	Target organization id when creating (from `fimo orgs list`).
`-y, --yes`	Skip the skills-install confirmation.
`--skills` / `--no-skills`	Set up Fimo skills, or skip them.
`--agents <list>`	Comma-separated agent IDs, e.g. `claude-code,cursor`.
`--install` / `--no-install`	Install dependencies after checkout, or skip.

In a non-interactive shell, the create-new path requires [dir], --install / --no-install, and --skills / --no-skills (and --org if you belong to multiple orgs and have no active one). A bare fimo init in a non-TTY will hang.

Right after scaffolding, set a human-readable name and start the local dev loop:

cd my-site
fimo rename "Acme Coffee"
pnpm dev              # or npm run dev / yarn dev / bun dev

Clone an existing project

fimo clone                      # interactive picker (active org)
fimo clone <projectId> [dir]    # clone a known project
fimo clone <projectId> --env <name>   # clone a specific environment

fimo clone clones the project’s git repo and writes the local .fimo.settings.json and agent files — the same as init --project-id. After it succeeds, cd in and load the project context (AGENTS.md + the project skill) before generating code.

Authentication & organizations

fimo login                            # browser sign-in
fimo whoami                           # active user + organization
fimo logout                           # revoke session, clear credentials
fimo orgs list                        # orgs you belong to
fimo orgs switch                       # change the active org (interactive)
fimo orgs switch --org <id-or-slug>    # explicit switch (required in non-TTY)

fimo switch is the environment switcher (an alias of fimo checkout), not the org switcher. To change your active organization, use fimo orgs switch.

What’s next

Content & CMS

Model and seed your content.

Install skills

Set your AI tool up for Fimo.

Collaboration

Invite teammates and clients.

Get started

Build with the CLI

Environments

Deploy & hosting

Scheduled agents

Migration

Collaboration & orgs

AI & MCP

Projects & onboarding

Create or link a project

Clone an existing project

Authentication & organizations

What’s next

Content & CMS

Install skills

Collaboration

​Create or link a project

​Clone an existing project

​Authentication & organizations

​What’s next

Content & CMS

Install skills

Collaboration

Create or link a project

Clone an existing project

Authentication & organizations

What’s next