amctl project

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

amctl project [command]

Subcommands

Command	Purpose
create	Create a new project
get	Show project details
list	List projects in the active organization
delete	Delete a project

Options inherited from parent commands

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

---

amctl project create

Create a new project in the active organization.

amctl project create <name> [flags]

Arguments

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

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

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

---

amctl project get

Show details of a project.

amctl project get <project>

Arguments

Name	Description
<project>	Project name.

Example

amctl project get checkout

---

amctl project list

List projects visible in the active organization.

amctl project list

Example

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

---

amctl project delete

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

amctl project delete <project> [flags]

Arguments

Name	Description
<project>	Project name to delete.

Options

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

Example

amctl project delete checkout --yes

See Also

• amctl agent — manage agents inside a project
• amctl context link — link the current directory to a project