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

gh-codespace(1)