# create

> For AI agents: the complete documentation index is at https://buddy.works/llms.txt

## Usage

```bash
bdy project create|add [options] <display-name>
```

Create a project Required scopes: PROJECT_WRITE

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `display-name` | Display name of the project (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `--context <name>` | Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation. |
| `--examples` | Show only examples; with this flag --format accepts text, json or jsonl |
| `--verbose` | Show REST API requests, responses, timing and retries on stderr |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-n, --name <name>` | Project name (human-readable ID). Generated from the display name when omitted |
| `-a, --access <access>` | Project access: PRIVATE (default), PUBLIC |
| `-s, --source <source>` | Repository source: BUDDY (default), NONE, GITHUB (GH), GITLAB (GL), BITBUCKET (BB) |
| `-i, --integration <hash_id:repository>` | Integration (hash ID or identifier) and repository to synchronize with, as <integration>:<org/repo>. Required by GITHUB, GITLAB and BITBUCKET sources |
| `-r, --allow-pull-requests` | Enable pull requests (GITHUB and GITLAB sources only) |
| `--format <text\|json>` | Output format: json, text. JSON CLI errors: {error:{code,message,hint}}, exit 1. Default: text (choices: "text", "json") |
| `-h, --help` | display help for command |

Documentation for bdy v1.25.34

## Examples

### Create a project with a Buddy repository

```bash
bdy project create "My Project"
```

### Create a public project with a given name and no repository

```bash
bdy project create "My Project" -n my-project -s NONE -a PUBLIC
```

### Create a project synchronized with a GitHub repository of an integration

```bash
bdy project create "My Project" -s GH -i github:my-org/my-repo -r
```

### Create a project and link the current directory to it

```bash
bdy project link -p "My Project"
```

### Return the created project as JSON

```bash
bdy project create "My Project" --format json
```


---
Original source: https://buddy.works/docs/cli/project/create