Skip to content

Releases

gcs v0.1.0

Choose a tag to compare

@aeroxy aeroxy released this 15 Nov 06:49

Google Cloud Shell from your terminal, without installing the gcloud SDK. gcs is one Rust binary that signs in like gcloud, stores credentials where gcloud does, and gives you ssh, scp and an ssh ProxyCommand for editors.

The problem it solves

Getting into Cloud Shell from your own machine has meant installing the whole Google Cloud SDK to run gcloud cloud-shell ssh. gcs calls the Cloud Shell API directly and connects your system ssh through the same WebSocket tunnel current gcloud uses, so there is nothing else to install and no SSH key to manage.

Key features

  • gcs ssh: an interactive shell, or a remote command (gcs ssh uptime). Arguments go to ssh unchanged, so port forwards (-N -L 8080:localhost:8080), a SOCKS5 proxy out through Cloud Shell (-N -D 7890), -f and -tt work as they do with plain ssh.
  • gcs scp: copies files both ways, with cs: marking the Cloud Shell side (gcs scp -r ./site cs:~/site).
  • No SSH keys: the tunnel reaches Cloud Shell's port 2222, which lets the session in without a key.
  • Starts Cloud Shell for you: ssh, scp, start and ssh-proxy wake a suspended environment first, which takes about half a minute.
  • Signs in like gcloud: gcs auth login writes the same ADC file gcloud auth login --update-adc writes, so gcloud, Google's client libraries and Terraform can share the sign-in. --no-browser covers machines without a local browser, and auth logout, auth status and auth token do what they say.
  • Or bring a token: --access-token, --access-token-file or --credentials, or $GCS_ACCESS_TOKEN, $GCS_ACCESS_TOKEN_FILE and $GOOGLE_APPLICATION_CREDENTIALS.
  • gcloud inside Cloud Shell: gcs ssh --authorize-session signs gcloud in there too and keeps it signed in while you are connected.
  • Editors: with gcs ssh-proxy as a host's ProxyCommand in ~/.ssh/config, Remote-SSH in VS Code, Zed and others opens Cloud Shell like any other host.
  • Agent skill: skills/gcs/SKILL.md teaches coding agents (Claude Code, opencode, …) to run commands in Cloud Shell, to ask you before signing in, and what to do about each error.

Install

brew install aeroxy/tap/gcs   # macOS arm64
cargo install --locked --git https://github.com/aeroxy/google-cloud-shell-cli --tag 0.1.0

Needs the OpenSSH client (ssh, scp) on your PATH.

Limitations

  • Direct connections only: HTTPS_PROXY and friends are ignored, because the WebSocket tunnel has no proxy support yet.
  • No key-based fallback (gcloud's deprecated AddPublicKey path).
  • Built and tested on macOS. Linux should work, and Windows is untested.