hostess projects
Create, list, and manage Hostess projects within your organizations.
Description
Manage Hostess projects within your organizations. A project corresponds to one hostess.yml configuration and contains all the services, deployments, environments, secrets, and domains for your application stack.
projects list
List all projects in an organization.
Usage
hostess projects list [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--org | string | Current organization | Organization slug |
Examples
hostess projects listProjects in 'my-org':
NAME DESCRIPTION
───────────────────────────────────────────────────
my-app E-commerce platform
blog Company blog
internal-tools Admin dashboards# List projects in a specific organization
hostess projects list --org other-orgprojects create
Create a new project in an organization.
Usage
hostess projects create <name> [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--org | string | Current organization | Organization slug |
--description | string | Project description |
Examples
# Create a project in the current org
hostess projects create my-new-app✓ Project 'my-new-app' created in organization 'my-org'# Create with a description
hostess projects create my-new-app --description "Next-gen e-commerce platform"
# Create in a specific organization
hostess projects create my-new-app --org other-orgYou can also create projects during hostess deploy. In an interactive terminal, the CLI offers to create a new project when needed.
projects info
Display detailed information about a project.
Usage
hostess projects info <name> [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--org | string | Current organization | Organization slug |
Examples
hostess projects info my-appProject: my-app
ID: proj_abc123def456
Organization ID: org_xyz789
Description: E-commerce platformprojects update
Update a project's name or description.
Usage
hostess projects update <name> [flags]At least one of --name or --description is required.
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--org | string | Current organization | Organization slug |
--name | string | New project name | |
--description | string | New project description |
Examples
# Rename a project
hostess projects update my-app --name my-app-v2✓ Project updated
Name: my-app-v2# Update description
hostess projects update my-app --description "Updated platform"
# Update both
hostess projects update my-app --name new-name --description "New description"projects delete
Permanently delete a project and all its resources.
Usage
hostess projects delete <name> [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--org | string | Current organization | Organization slug |
--force | bool | false | Skip confirmation prompt |
Examples
# Delete with confirmation
hostess projects delete old-projectAre you sure you want to delete project 'old-project'?
This will delete all environments, deployments, and cannot be undone.
Type 'yes' to confirm: yes
✓ Project 'old-project' deleted# Delete without confirmation
hostess projects delete old-project --forceDeleting a project permanently removes all environments, deployments, services, secrets, and domains associated with it.