Repository navigation
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),-fand-ttwork as they do with plain ssh.gcs scp: copies files both ways, withcs: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,startandssh-proxywake a suspended environment first, which takes about half a minute. - Signs in like gcloud:
gcs auth loginwrites the same ADC filegcloud auth login --update-adcwrites, so gcloud, Google's client libraries and Terraform can share the sign-in.--no-browsercovers machines without a local browser, andauth logout,auth statusandauth tokendo what they say. - Or bring a token:
--access-token,--access-token-fileor--credentials, or$GCS_ACCESS_TOKEN,$GCS_ACCESS_TOKEN_FILEand$GOOGLE_APPLICATION_CREDENTIALS. - gcloud inside Cloud Shell:
gcs ssh --authorize-sessionsigns gcloud in there too and keeps it signed in while you are connected. - Editors: with
gcs ssh-proxyas a host'sProxyCommandin~/.ssh/config, Remote-SSH in VS Code, Zed and others opens Cloud Shell like any other host. - Agent skill:
skills/gcs/SKILL.mdteaches 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.0Needs the OpenSSH client (ssh, scp) on your PATH.
Limitations
- Direct connections only:
HTTPS_PROXYand friends are ignored, because the WebSocket tunnel has no proxy support yet. - No key-based fallback (gcloud's deprecated
AddPublicKeypath). - Built and tested on macOS. Linux should work, and Windows is untested.