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¶

gh-codespace(1)