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

# projects

> CLI reference: floo projects, create, list, and clone managed apps without a GitHub account

Create, list, and clone managed apps without a GitHub account. These are subcommands of `floo projects`.

The [agent recipe](https://getfloo.com/agents.md) covers the managed app workflow.

## create

Create and deploy a managed app with hosted, invite-only login and postgres.

Usage: `floo projects create <NAME>`.

Names must be 2 to 40 characters, contain only lowercase letters, digits, and hyphens, and start with a letter.

The command starts the first deploy from a Next.js template and returns:

* The app URL: `https://<name>-dev.on.getfloo.com`.
* A private repository floo hosts in its own GitHub organization.
* Hosted, invite-only login with `access_mode = "accounts"`.
* Managed Postgres injected as `DATABASE_URL`.

### Flags

| Flag     | Description    |
| -------- | -------------- |
| `--json` | Output as JSON |

### Example

```bash theme={null}
floo projects create my-app --json
```

***

## list

List managed projects in the current organization.

### Flags

| Flag     | Description    |
| -------- | -------------- |
| `--json` | Output as JSON |

### Example

```bash theme={null}
floo projects list --json
```

***

## clone

Clone a managed project and configure credentials only in that repository.

Usage: `floo projects clone <NAME_OR_ID> [DIR]`. Pass the project name or ID and an optional destination directory.

The command runs `git clone` and sets a repository-local git credential helper: `credential.helper` points at the floo binary, and `credential.useHttpPath=true`. Tokens are minted per git operation, scoped to that one repository, expire in an hour, and are never stored. Do not run `gh` or edit the remote.

### Flags

| Flag     | Description    |
| -------- | -------------- |
| `--json` | Output as JSON |

### Example

```bash theme={null}
floo projects clone my-app ./my-app
cd my-app
cat AGENTS.md
```