# amctl project

Manage projects in an organization. Projects group agents and own the build and deploy pipeline.

```
amctl project [command]
```

## Subcommands[​](#subcommands "Direct link to Subcommands")

| Command                           | Purpose                                  |
| --------------------------------- | ---------------------------------------- |
| [`create`](#amctl-project-create) | Create a new project                     |
| [`get`](#amctl-project-get)       | Show project details                     |
| [`list`](#amctl-project-list)     | List projects in the active organization |
| [`delete`](#amctl-project-delete) | Delete a project                         |

## Options inherited from parent commands[​](#options-inherited-from-parent-commands "Direct link to Options inherited from parent commands")

| Name     | Description                       |
| -------- | --------------------------------- |
| `--org`  | Override the active organization. |
| `--json` | Output as JSON envelopes.         |

***

## amctl project create[​](#amctl-project-create "Direct link to amctl project create")

Create a new project in the active organization.

```
amctl project create <name> [flags]
```

### Arguments[​](#arguments "Direct link to Arguments")

| Name     | Description                                                     |
| -------- | --------------------------------------------------------------- |
| `<name>` | Project name. URL-safe slug used in CLI commands and API paths. |

### Examples[​](#examples "Direct link to Examples")

```
# Create a project with required display name
amctl project create checkout --display-name "Checkout API"

# With a description
amctl project create checkout \
  --display-name "Checkout API" \
  --description "Order checkout, payments, fulfillment"
```

### Options[​](#options "Direct link to Options")

| Name             | Type   | Default    | Description                    |
| ---------------- | ------ | ---------- | ------------------------------ |
| `--display-name` | string | *required* | Human-readable display name.   |
| `--description`  | string | (none)     | Free-text project description. |

***

## amctl project get[​](#amctl-project-get "Direct link to amctl project get")

Show details of a project.

```
amctl project get <project>
```

### Arguments[​](#arguments-1 "Direct link to Arguments")

| Name        | Description   |
| ----------- | ------------- |
| `<project>` | Project name. |

### Example[​](#example "Direct link to Example")

```
amctl project get checkout
```

***

## amctl project list[​](#amctl-project-list "Direct link to amctl project list")

List projects visible in the active organization.

```
amctl project list
```

### Example[​](#example-1 "Direct link to Example")

```
amctl project list --json | jq '.data.projects[].name'
```

***

## amctl project delete[​](#amctl-project-delete "Direct link to amctl project delete")

Delete a project. Asks for confirmation unless `--yes` is set.

```
amctl project delete <project> [flags]
```

### Arguments[​](#arguments-2 "Direct link to Arguments")

| Name        | Description             |
| ----------- | ----------------------- |
| `<project>` | Project name to delete. |

### Options[​](#options-1 "Direct link to Options")

| Name    | Short | Type | Default | Description                   |
| ------- | ----- | ---- | ------- | ----------------------------- |
| `--yes` | `-y`  | bool | `false` | Skip the confirmation prompt. |

### Example[​](#example-2 "Direct link to Example")

```
amctl project delete checkout --yes
```

## See Also[​](#see-also "Direct link to See Also")

* [`amctl agent`](/agent-manager/docs/next/cli/agent/.md) — manage agents inside a project
* [`amctl context link`](/agent-manager/docs/next/cli/context/.md#amctl-context-link) — link the current directory to a project