Skip to content

carapace-sh/carapace-bin / skills/gh

Use when working with the GitHub CLI (`gh`) — authentication, repositories, pull requests, issues, releases, GitHub Actions (workflows, runs, caches), the gh API command, extensions, secrets and variables, search, gists, SSH/GPG keys, labels, rulesets, codespaces, browsing, configuration, aliases, JSON output formatting, and environment variables. Triggers on: "gh", "gh auth", "gh repo", "gh pr", "gh issue", "gh release", "gh run", "gh workflow", "gh api", "gh extension", "gh secret", "gh variable", "gh search", "gh gist", "gh label", "gh codespace", "gh browse", "gh status", "gh config", "gh alias", "gh completion", "gh ssh-key", "gh gpg-key", "gh ruleset", "gh cache", "gh org", "GH_TOKEN", "GH_REPO", "GH_HOST", "gh pr create", "gh pr checkout", "gh pr merge", "gh repo clone", "gh repo create", "gh issue create", "gh release create", "gh workflow run", "gh run list", "gh api graphql", "gh extension install", "gh secret set", "gh search repos".

FileKindSize
SKILL.mdskill md9.8 KB
references/actions.mdmarkdown10.1 KB
references/api.mdmarkdown6.5 KB
references/auth.mdmarkdown7.4 KB
references/browse-status.mdmarkdown5.6 KB
references/config.mdmarkdown8.3 KB
references/extension.mdmarkdown5.4 KB
references/gist-keys.mdmarkdown9.3 KB
references/issue.mdmarkdown9.9 KB
references/output-formatting.mdmarkdown5.2 KB
references/pr.mdmarkdown14.2 KB
references/release.mdmarkdown8.3 KB
references/repo.mdmarkdown10.3 KB
references/search.mdmarkdown10.7 KB
references/secret-variable.mdmarkdown7.0 KB

references/browse-status.md

View on GitHub
# Browse, Status, and Codespaces

How to open things in the browser, view work status, and manage codespaces with `gh`.

## Browse

`gh browse` opens repositories, issues, pull requests, files, commits, and more in the web browser.

### Argument Format

A browser location can be specified as:
- By number (issue or PR) — e.g. `123`
- By path (folders and files) — e.g. `cmd/gh/main.go`
- By commit SHA
- With line number — `path:line` (e.g. `main.go:312`)

### Usage

```sh
$ gh browse                    # open repo home page
$ gh browse script/            # open a directory
$ gh browse 217                # open issue or PR 217
$ gh browse 77507cd94ccafcf... # open commit page
$ gh browse --settings         # open settings
$ gh browse main.go:312        # open file at line
$ gh browse main.go:312 --blame   # blame view
$ gh browse main.go --branch bug-fix
$ gh browse main.go --commit=77507cd
$ gh browse --no-browser       # print URL only
```

| Flag | Description |
|------|-------------|
| `-a, --actions` | Open repository actions |
| `--blame` | Open blame view for a file |
| `-b, --branch string` | Select another branch |
| `-c, --commit string[="last"]` | Select a commit by SHA (default: last commit) |
| `-n, --no-browser` | Print URL instead of opening browser |
| `-p, --projects` | Open repository projects |
| `-r, --releases` | Open repository releases |
| `-R, --repo [HOST/]OWNER/REPO` | Select another repository |
| `-s, --settings` | Open repository settings |
| `-w, --wiki` | Open repository wiki |

The `BROWSER` or `GH_BROWSER` environment variable configures the web browser.

## Status

`gh status` prints information about your work on GitHub across all subscribed repositories:

- Assigned Issues
- Assigned Pull Requests
- Review Requests
- Mentions
- Repository Activity (new issues/PRs, comments)

```sh
$ gh status
$ gh status -e cli/cli -e cli/go-gh    # exclude repos
$ gh status -o cli                      # limit to an organization
```

| Flag | Description |
|------|-------------|
| `-e, --exclude strings` | Comma-separated repos to exclude (owner/name format) |
| `-o, --org string` | Report status within an organization |

## Codespaces

`gh codespace` (aliased `gh cs`) connects to and manages codespaces.

### Subcommands

| Subcommand | Description |
|------------|-------------|
| `code` | Open a codespace in VS Code |
| `cp` | Copy files between local and remote codespace |
| `create` | Create a codespace |
| `delete` | Delete a codespace |
| `edit` | Edit a codespace |
| `jupyter` | Open a codespace in JupyterLab |
| `list` | List codespaces |
| `logs` | Access codespace logs |
| `ports` | List and manage forwarded ports |
| `rebuild` | Rebuild a codespace |
| `ssh` | SSH into a codespace |
| `stop` | Stop a codespace |
| `view` | View details about a codespace |

### `gh codespace create`

```sh
$ gh codespace create                          # interactive
$ gh codespace create --repo cli/cli
$ gh codespace create --repo cli/cli --branch develop
$ gh codespace create --machine basicLinux32gb
$ gh codespace create --display-name "My Codespace"
$ gh codespace create --idle-timeout 30m
$ gh codespace create --retention-period 720h
$ gh codespace create --location WestUs2
$ gh codespace create --web
```

Key flags for `create`:

| Flag | Description |
|------|-------------|
| `-b, --branch string` | Repository branch |
| `--default-permissions` | Do not prompt to accept additional permissions requested by the codespace |
| `--devcontainer-path string` | Path to devcontainer.json |
| `-d, --display-name string` | Display name (48 characters or less) |
| `--idle-timeout duration` | Allowed inactivity before stopping, e.g. `10m`, `1h` |
| `-l, --location string` | Location: `EastUs`, `SouthEastAsia`, `WestEurope`, `WestUs2` |
| `-m, --machine string` | Hardware specifications for the VM |
| `-R, --repo string` | Repository name with owner: `user/repo` |
| `--retention-period duration` | Allowed time after shutdown before auto-deletion (max 30 days), e.g. `1h`, `72h` |
| `-s, --status` | Show status of post-create command and dotfiles |
| `-w, --web` | Create codespace from browser |

### `gh codespace list`

List codespaces.

```sh
$ gh codespace list
$ gh codespace list --limit 50
```

### `gh codespace code`

Open a codespace in VS Code.

```sh
$ gh codespace code                    # interactive
$ gh codespace code -c <codespace-name>
$ gh codespace code --web              # open in VS Code Web
```

### `gh codespace ssh`

SSH into a codespace.

```sh
$ gh codespace ssh
$ gh codespace ssh -c <codespace-name>
$ gh codespace ssh --profile <profile-name>
```

### `gh codespace logs`

Access codespace logs.

### `gh codespace ports`

List and manage forwarded ports.

```sh
$ gh codespace ports
$ gh codespace ports visibility 8000:public   # change port visibility
$ gh codespace ports forward 8000:8000        # forward a port
```

### `gh codespace cp`

Copy files between local and remote codespace using `scp` syntax.

```sh
$ gh codespace cp -c <name> remote.txt local.txt
$ gh codespace cp -c <name> ./localdir remote:/workspace
```

### `gh codespace view`

View details about a codespace.

```sh
$ gh codespace view
$ gh codespace view -c <codespace-name>
```

### `gh codespace delete`

Delete a codespace.

### `gh codespace stop`

Stop a running codespace.

### `gh codespace rebuild`

Rebuild a codespace.

### `gh codespace edit`

Edit a codespace's settings (display name, machine type, idle timeout).

### `gh codespace jupyter`

Open a codespace in JupyterLab.

## Related

- For environment variables (`BROWSER`, `GH_BROWSER`), see [config.md](config.md).
- For repository targeting (`--repo`), see [repo.md](repo.md).
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall