> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fimo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects & onboarding

> Create or link a Fimo project, clone it locally, and manage authentication and organizations.

`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

```bash theme={null}
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.                     |

<Note>
  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.
</Note>

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

```bash theme={null}
cd my-site
fimo rename "Acme Coffee"
pnpm dev              # or npm run dev / yarn dev / bun dev
```

## Clone an existing project

```bash theme={null}
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

```bash theme={null}
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)
```

<Warning>
  `fimo switch` is the **environment** switcher (an alias of `fimo checkout`), not the org switcher. To change your active organization, use `fimo orgs switch`.
</Warning>

## What's next

<Columns cols={3}>
  <Card title="Content & CMS" icon="database" href="/docs/cli/content">
    Model and seed your content.
  </Card>

  <Card title="Install skills" icon="plug" href="/docs/get-started/install-skills">
    Set your AI tool up for Fimo.
  </Card>

  <Card title="Collaboration" icon="user-plus" href="/docs/collaboration/invite">
    Invite teammates and clients.
  </Card>
</Columns>