Skip to main content
⏳ Estimated read time: 2 min read
Important

With the July 2025 release, Teams has been renamed to Projects across the StackGen platform. This change reflects our broader vision of enabling cross-functional collaboration around infrastructure, code, and compliance workflows under clearly scoped project workspaces. All existing functionality remains the same and only the terminology has been updated to better align with how you organize and manage appStacks, modules, and cloud environments in real-world settings. You’ll now see Projects wherever Teams was previously referenced in the UI, CLI, and documentation.

View Projects

The stackgen project command retrieves projects within your StackGen organisation. It supports subcommands to list the projects available to the authenticated user.

Usage

stackgen project list

Lists all Projects accessible to the currently authenticated user.

Use this command when:

  • You need to reference project UUIDs in scripts or automation pipelines.
  • You're deploying infra (e.g., Terraform modules) across projects.
  • You want a CLI-based alternative to viewing project membership in the UI.

Role-Based Behavior

Admin users: Returns all projects within the org.
Developer users: Returns only the projects the user is a member of.

Flags

FlagDescription
-h, --helpHelp for the project list command
-i, --interactiveRun CLI in interactive mode
--log intSet log level: 2 = DEBUG, 3 = INFO (default), 4 = WARN, 5 = ERROR
-o, --outputSet output format: json, human, or raw (default: human)
--project stringSpecify the UUID of a project (optional; used in other commands)

Example

stackgen project list --output json

Sample Outputs

Output for Admins

[
{
"name": "Platform Engineering",
"uuid": "project-abc123"
},
{
"name": "DevOps Project",
"uuid": "project-def456"
}
]

Output for Developers

[
{
"name": "DevOps Project",
"uuid": "project-def456"
}
]