gh-codespace

name	gh-codespace
description	GitHub CLI (`gh codespace` or `gh cs`) operations for connecting to, managing, creating, or editing GitHub Codespaces. You MUST load this skill when working with the `gh codespace` command.
license	MIT

gh-codespace

Connect to and manage GitHub Codespaces natively from the CLI.

WHEN TO USE

• When managing, creating, or connecting to GitHub Codespaces natively from the CLI.
• When you need to securely transfer files between the local machine and a Codespace without configuring SCP manually.
• To handle port forwarding for local testing of applications running inside a Codespace.

WHEN NOT TO USE

• For managing local Docker containers or Devcontainers not hosted on GitHub's infrastructure (use docker or devcontainer skills instead).
• When attempting to perform automated Git commits (the agent should use native local git tools instead of proxying through a Codespace).
• If the user explicitly asks to work locally and has not initialized a Codespace environment.

Mindmap of Commands

mindmap
  root((gh-codespace))
    code
      Open in VS Code
    cp
      Copy files
    create
      Create a codespace
    delete
      Delete codespaces
    edit
      Edit a codespace
    jupyter
      Open in JupyterLab
    list
      List codespaces
    logs
      Access codespace logs
    ports
      List and manage ports
    rebuild
      Rebuild a codespace
    ssh
      SSH into a codespace
    stop
      Stop a codespace
    view
      View details

Common Pitfalls

• Interactive Hangs: Running in an automated agent session, which blocks execution by dropping the agent into an interactive TTY shell.