gh-codespace-list1
List codespaces
Usage
gh codespace
list
[flags]
Overview
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 status
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.
Releases
3 releases since Debian 12 (Bookworm); the text changed 2 times.
--web since Debian 13 (Trixie);
-w since Debian 13 (Trixie).
--limit until Debian 12 (Bookworm);
-L until Debian 12 (Bookworm).