gh-codespace-list(1)

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.

  1. 12
  2. 13
  3. Arch

--web since Debian 13 (Trixie); -w since Debian 13 (Trixie).

--limit until Debian 12 (Bookworm); -L until Debian 12 (Bookworm).

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.