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

# formae project

> Scaffold a forma project. Reference for formae project and its subcommands.

Work with formae projects. A project ties your forma files to the plugin schemas
they depend on, so PKL can resolve the resource types you use.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae project init [flags]
```

### Examples

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae project init
```

## formae project init

Initialize a project in the current directory.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae project init [flags]
```

### Flags

| Flag                  | Default                 | Description                                                                                               |
| --------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------- |
| `--include <package>` |                         | Packages to include. Repeatable. Use the `@local` suffix for local plugins, for example `myplugin@local`. |
| `--plugin-dir <path>` | `~/.pel/formae/plugins` | Directory to scan for `@local` plugin schemas.                                                            |
| `--schema <pkl>`      | `pkl`                   | Schema to use for the project.                                                                            |
| `-y`, `--yes`         | `false`                 | Skip confirmation prompts.                                                                                |
| `--config <path>`     |                         | Path to a config file.                                                                                    |
| `--profile <name>`    |                         | Named profile to use.                                                                                     |