bdy project create

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

Create a project Required scopes: PROJECT_WRITE

ARGUMENTS

display-name

Display name of the project (required)

OPTIONS

--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

Last modified on Nov 3, 2026

yaml delete

Examples

Create a project with a Buddy repository

bdy project create "My Project"$

Create a public project with a given name and no repository

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

Create a project synchronized with a GitHub repository of an integration

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

Create a project and link the current directory to it

bdy project link -p "My Project"$

Return the created project as JSON

bdy project create "My Project" --format json$