| GH-CODESPACE-LIST(1) | GitHub CLI manual | GH-CODESPACE-LIST(1) |
NAME
gh-codespace-list - List codespaces
SYNOPSIS
gh codespace list [flags]
DESCRIPTION
List codespaces of the authenticated user.
Alternatively, organization administrators may list all codespaces billed to the organization.
OPTIONS
- -q, --jq <expression>
- Filter JSON output using a jq expression
- --json <fields>
- Output JSON with the specified fields
- -L, --limit <int> (default 30)
- Maximum number of codespaces to list
- -o, --org <login>
- The login handle of the organization to list codespaces for (admin-only)
- -R, --repo <string>
- Repository name with owner: user/repo
- -t, --template <string>
- Format JSON output using a Go template; see "gh help formatting"
- -u, --user <username>
- The username to list codespaces for (used with --org)
- -w, --web
- List codespaces in the web browser, cannot be used with --user or --org
ALIASES
gh codespace ls, gh cs ls
JSON FIELDS
createdAt, displayName, gitStatus, lastUsedAt, machineName, name, owner, repository, state, vscsTarget
EXIT CODES
0: Successful execution
1: Error
2: Command canceled
4: Authentication required
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.
SEE ALSO
| Jun 2025 |