A terminal UI for Google Cloud
Browse and operate your Google Cloud projects from the keyboard, in the spirit of k9s. nuvem works with the gcloud configurations you already have, and shows you what it is about to do before it changes anything.
brew install filipeaaoliveira/tap/nuvem Homebrew on macOS and Linux. Or install with cargo, download a release binary, or build from source.
Try it first with nuvem --demo, on sample data with no account. Your own projects need the gcloud CLI, signed in. See First run.
┌Inventory─────────────────────── │GCE instances 10 loaded │GKE clusters 5 loaded │Cloud SQL 7 loaded │Cloud Run 7 loaded │Cloud Storage 7 loaded │Secret Manager 7 loaded │Cloud Functions 7 loaded │Persistent disks 8 loaded │Pub/Sub topics 6 loaded │Pub/Sub subscriptions 8 loaded │BigQuery datasets 5 loaded │Service accounts 9 loaded │IAM policy 12 loaded │VPC networks 4 loaded │VPC subnets 7 loaded │Firewall rules 8 loaded └────────────────────────────────
nuvem Home Configuration: dev Project: dev-project Account: dev@example.com Region: europe-west1 Zone: europe-west1-b Home ┌Context─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │Configuration: dev │ │Account: dev@example.com │ │Region/Zone: europe-west1/europe-west1-b │ │Project: dev-project │ │gcloud: available (dev@example.com) │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ┌Inventory───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │GCE instances 10 loaded Pending 1 Running 7 Stopped 1 Suspended 1 │ │GKE clusters 5 loaded Provisioning 1 Reconciling 1 Running 3 │ │Cloud SQL 7 loaded Maintenance 1 Runnable 5 Stopped 1 │ │Cloud Run 7 loaded Not ready 1 Ready 5 Reconciling 1 │ │Cloud Storage 7 loaded │ │Secret Manager 7 loaded │ │Cloud Functions 7 loaded Active 5 Deploying 1 Failed 1 │ │Persistent disks 8 loaded Ready 7 Restoring 1 │ │Pub/Sub topics 6 loaded │ │Pub/Sub subscriptions 8 loaded Active 7 Resource error 1 │ │BigQuery datasets 5 loaded │ │Service accounts 9 loaded │ │IAM policy 12 loaded │ │VPC networks 4 loaded │ │VPC subnets 7 loaded │ │Firewall rules 8 loaded │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ┌Recent operations───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │No recent operations │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ [OK] Home Updated: just now r Refresh g Resources c Configurations q Quit : Command palette ? Help
Press a key
Real screens from nuvem --demo, set as text. Click a key, or move to the keys with Tab and type one.
Home (h)
nuvem Home Configuration: dev Project: dev-project Account: dev@example.com Region: europe-west1 Zone: europe-west1-b Home ┌Context─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │Configuration: dev │ │Account: dev@example.com │ │Region/Zone: europe-west1/europe-west1-b │ │Project: dev-project │ │gcloud: available (dev@example.com) │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ┌Inventory───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │GCE instances 10 loaded Pending 1 Running 7 Stopped 1 Suspended 1 │ │GKE clusters 5 loaded Provisioning 1 Reconciling 1 Running 3 │ │Cloud SQL 7 loaded Maintenance 1 Runnable 5 Stopped 1 │ │Cloud Run 7 loaded Not ready 1 Ready 5 Reconciling 1 │ │Cloud Storage 7 loaded │ │Secret Manager 7 loaded │ │Cloud Functions 7 loaded Active 5 Deploying 1 Failed 1 │ │Persistent disks 8 loaded Ready 7 Restoring 1 │ │Pub/Sub topics 6 loaded │ │Pub/Sub subscriptions 8 loaded Active 7 Resource error 1 │ │BigQuery datasets 5 loaded │ │Service accounts 9 loaded │ │IAM policy 12 loaded │ │VPC networks 4 loaded │ │VPC subnets 7 loaded │ │Firewall rules 8 loaded │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ┌Recent operations───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │No recent operations │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ [OK] Home Updated: just now r Refresh g Resources c Configurations q Quit : Command palette ? Help
┌Inventory──────────────────────────────────── │GCE instances 10 loaded Pending 1 │GKE clusters 5 loaded Provisioning │Cloud SQL 7 loaded Maintenance │Cloud Run 7 loaded Not ready 1 │Cloud Storage 7 loaded │Secret Manager 7 loaded │Cloud Functions 7 loaded Active 5 │Persistent disks 8 loaded Ready 7 │Pub/Sub topics 6 loaded │Pub/Sub subscriptions 8 loaded Active 7 │BigQuery datasets 5 loaded │Service accounts 9 loaded │IAM policy 12 loaded │VPC networks 4 loaded │VPC subnets 7 loaded │Firewall rules 8 loaded └─────────────────────────────────────────────
Home shows the active gcloud configuration and how many resources each service holds. Home.
Services (g)
nuvem Resources Configuration: dev Project: dev-project Account: dev@example.com Service: GCE instances Region: europe-west1 Zone: europe-west1-b Home > Resources > GCE instances ┌Service navigator─────────┐Filter: none Sort: Name ▲ Rows: 10/10 ←/→ col · s sort +1 cols (w) ┌Preview──────────────────┐ │ Analytics │┌Resources / GCE instances────────────────────────────────────────────────────────┐│api-dev-1 │ │ BigQuery datasets ││ [NAME▲] STATUS ZONE MACHINE-TYPE INTERNAL-IP ││Status: Running │ │ Compute ││> api-dev-1 Running europe-west1-b e2-medium 10.132.0.4 ││Zone: europe-west1-b │ │> GCE instances ││ bastion Running europe-west1-b e2-micro 10.132.0.2 ││Machine Type: e2-medium │ │ Containers ││ batch-runner Running europe-west1-d n2-standard-4 10.132.0.21 ││Internal IP: 10.132.0.4 │ │ GKE clusters ││ ci-runner-1 Suspended us-central1-a n2-standard-8 10.128.0.7 ││External IP: 203.0.113.20│ │ Databases ││ file-server-a Running europe-west1-b n2-standard-2 10.132.0.50 ││ │ │ Cloud SQL ││ file-server-b Running europe-west1-c n2-standard-2 10.132.0.51 ││ │ │ Messaging ││ reporting-proxy Pending europe-west1-c e2-small 10.132.0.30 ││ │ │ Pub/Sub topics ││ web-frontend-1 Running europe-west1-b e2-standard-2 10.132.0.11 ││ │ │ Pub/Sub subscriptions ││ web-frontend-2 Running europe-west1-c e2-standard-2 10.132.0.12 ││ │ │ Networking ││ worker-dev-1 Stopped europe-west1-b e2-small 10.132.0.5 ││ │ │ VPC networks ││ ││ │ │ VPC subnets ││ ││ │ │ Firewall rules ││ ││ │ │ Security ││ ││ │ │ Secret Manager ││ ││ │ │ Service accounts ││ ││ │ │ IAM policy ││ ││ │ │ Serverless ││ ││ │ │ Cloud Run ││ ││ │ │ Cloud Functions ││ ││ │ │ Storage ││ ││ │ │ Persistent disks ││ ││ │ │ Cloud Storage ││ ││ │ │ ││ ││ │ └──────────────────────────┘└─────────────────────────────────────────────────────────────────────────────────┘└─────────────────────────┘ [OK] GCE instances Updated: just now Enter Open / Filter s Sort column w Wide columns ←/→ Select column r Refresh v Toggle sidebar : Command palette ? Help
┌Service navigator─────────┐ │ Analytics │ │ BigQuery datasets │ │ Compute │ │> GCE instances │ │ Containers │ │ GKE clusters │ │ Databases │ │ Cloud SQL │ │ Messaging │ │ Pub/Sub topics │ │ Pub/Sub subscriptions │ │ Networking │ │ VPC networks │ │ VPC subnets │ │ Firewall rules │ │ Security │ │ Secret Manager │ │ Service accounts │ │ IAM policy │ │ Serverless │ │ Cloud Run │ │ Cloud Functions │ │ Storage │ │ Persistent disks │ │ Cloud Storage │ │ │ └──────────────────────────┘
g opens Resources: sixteen services in a sidebar, grouped by kind, each a list you can sort. Services.
Filter, open (/ then Enter)
nuvem GCE instances detail Configuration: dev Project: dev-project Account: dev@example.com Service: GCE instances Region: europe-west1 Zone: europe-west1-b Home > Resources > GCE instances > web-frontend-1 > Summary Filter: web [regex] Sort: Name ▲ Rows: 2/10 s sort +1 cols (w) ┌GCE instance detail─────────────────────────────────────────┐ ┌Resources / GCE instances─────────────────────────────────────────────────┐│GCE instance / web-frontend-1 │ │ [NAME▲] STATUS ZONE MACHINE-TYPE INTERNAL-IP ││[Summary] | Network | Disks | Metadata | JSON │ │> web-frontend-1 Running europe-west1-b e2-standard-2 10.132.0.11 ││[ and ] tabs n/p field y copy Esc/q return to list │ │ web-frontend-2 Running europe-west1-c e2-standard-2 10.132.0.12 ││ │ │ ││Name: web-frontend-1 │ │ ││Status: Running │ │ ││Zone: europe-west1-b │ │ ││Machine type: e2-standard-2 │ │ ││Creation: 2026-03-02T09:15:00.000-08:00 │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ └──────────────────────────────────────────────────────────────────────────┘└────────────────────────────────────────────────────────────┘ [OK] GCE instances detail Updated: just now [ Previous tab ] Next tab PgUp/PgDn Scroll r Refresh q/Esc/Alt-← Back : Command palette ? Help
┌GCE instance detail────────────────────────── │GCE instance / web-frontend-1 │[Summary] | Network | Disks | Metadata | JSON │[ and ] tabs n/p field y copy │ │Name: web-frontend-1 │Status: Running │Zone: europe-west1-b │Machine type: e2-standard-2 │Creation: 2026-03-02T09:15:00.000-08:00 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └─────────────────────────────────────────────
Filter by regex, fuzzy match, label or inverse match, then open a row with Enter. Filter a list.
Command palette (:)
nuvem Resources Configuration: dev Project: dev-project Account: dev@example.com Service: GCE instances Region: europe-west1 Zone: europe-west1-b Home > Resources > GCE instances ┌commands──────────────────────────────────────────────────────────────────────────────────────┐ │Search: _ │ │> Stop selected GCE instance │ │ Reset selected GCE instance │ │ Suspend selected GCE instance │ │ Show SSH command for selected GCE instance │ │ SSH to selected GCE instance (ssh) │ │ Start tunnel for selected GCE instance (tunnel, pf, forward) t│ │ Copy selected instance name │ │ Copy selected instance zone │ │ Copy selected instance internal IP │ │ Copy selected instance external IP │ │ Copy selected instance self link │ │ Open logs for selected GCE instance (logs) L│ │ Home (home) h│ │ Configurations (configurations, configs, config) c│ │ Tunnels (tunnels, pf, forward, port forward) Ctrl-t│ │ FinOps (finops, cost, costs, savings, budget, spend) Ctrl-f│ │ GCE instances (gce, compute engine, instances) │ │ GKE clusters (gke, kubernetes, clusters) │ │ Cloud SQL (cloud sql, sql, database, postgres, mysql) │ │ Cloud Run (run, serverless) │ │ Cloud Storage (gcs, storage, bucket, buckets) │ │ Secret Manager (secret, secrets, secret manager, sm) │ │ Cloud Functions (functions, gcf, cloud functions) │ │ Persistent disks (disks, pd, persistent disks, orphans) │ │ Pub/Sub topics (pubsub, pub/sub, topics, pubsub topics, pubsub-topics) │ └──────────────────────────────────────────────────────────────────────────────────────────────┘ [OK] GCE instances Updated: just now ↑/↓ Select Enter Run Esc Cancel
┌commands───────────────────────────────────── │Search: _ │> Stop selected GCE instance │ Reset selected GCE instance │ Suspend selected GCE instance │ Show SSH command for selected GCE instance │ SSH to selected GCE instance (ssh) │ Start tunnel for selected GCE instance │ Copy selected instance name │ Copy selected instance zone │ Copy selected instance internal IP │ Copy selected instance external IP │ Copy selected instance self link │ Open logs for selected GCE instance (logs) │ Home (home) │ Configurations │ Tunnels │ FinOps │ GCE instances │ GKE clusters (gke, kubernetes, clusters) │ Cloud SQL │ Cloud Run (run, serverless) │ Cloud Storage │ Secret Manager │ Cloud Functions │ Persistent disks │ Pub/Sub topics └─────────────────────────────────────────────
Run a command by name instead of remembering its key. Command palette.
Lifecycle (Space then :)
nuvem Resources Configuration: dev Project: dev-project Account: dev@example.com Service: GCE instances Region: europe-west1 Zone: europe-west1-b Home > Resources > GCE instances ┌confirm GCE action──────────────────────────────────────────────────────────────────────────────────────────┐ │Confirm GCE action │ │ │ │Action: Stop instance │ │Instance: web-frontend-1 │ │Zone: europe-west1-b │ │Configuration: dev │ │Project: dev-project │ │Impact: Guest OS halts and the instance stops; billing pauses. │ │Call: compute.instances.stop zones/europe-west1-b/instances/web-frontend-1 │ │Enter confirm Esc cancel │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ [OK] GCE instances Updated: just now Enter Confirm Esc Cancel
┌confirm GCE action─────────────────────────── │Confirm GCE action │ │Action: Stop instance │Instance: web-frontend-1 │Zone: europe-west1-b │Configuration: dev │Project: dev-project │Impact: Guest OS halts and the instance │Call: compute.instances.stop │Enter confirm Esc cancel │ │ │ │ │ │ │ │ └─────────────────────────────────────────────
Mark rows with Space to act on several at once. The confirmation shows the API call first. Lifecycle actions.
BigQuery (Enter)
nuvem Resources Configuration: dev Project: dev-project Account: dev@example.com Service: BigQuery datasets Region: europe-west1 Zone: europe-west1-b Home > Resources > BigQuery datasets > analytics Filter: none Rows: 3/3 w wide ┌Preview──────────────────────┐ ┌Resources / BigQuery analytics───────────────────────────────────────────────────────────────────────────┐│daily_active_users │ │ TABLE TYPE CREATED ROWS BYTES LAST MODIFIED ││Type: Table │ │> daily_active_users Table 2026-01-01T09:00:00Z 730 68.4 KiB 2026-08-29T10:40:00Z ││Created: 2026-01-01T09:00:00Z│ │ orders_summary View 2026-01-02T09:00:00Z 0 0 B 2026-08-29T11:40:00Z ││Dataset: analytics │ │ sessions Table 2026-01-03T09:00:00Z 1823311 166.9 MiB 2026-08-29T12:40:00Z ││Labels: - │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ └─────────────────────────────────────────────────────────────────────────────────────────────────────────┘└─────────────────────────────┘ [OK] BigQuery analytics Updated: 6s ago Enter Open Esc Leave drill-down / Filter w Wide columns r Refresh v Toggle sidebar Tab Focus sidebar : Command palette ? Help
┌Preview──────────────────────┐ │daily_active_users │ │Type: Table │ │Created: 2026-01-01T09:00:00Z│ │Dataset: analytics │ │Labels: - │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └─────────────────────────────┘
Enter on a BigQuery dataset lists its tables, with the selected one in a preview. BigQuery datasets.
Help (?)
nuvem Resources Configuration: dev Project: dev-project Account: dev@example.com Service: GCE instances Region: europe-west1 Zone: europe-west1-b ┌help────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │Resources │ │Current view │ │v Toggle sidebar │ │Tab Focus sidebar │ │/ Filter │ │s Sort column │ │w Wide columns │ │←/→ Select column │ │j/k Move selection │ │Enter Open │ │Space Mark │ │V Range mark │ │\ Clear marks │ │U Unmark visible │ │t Start tunnel │ │L Logs for the selected resource (l: all project logs) │ │J Related-resource jumps │ │, Run plugin │ │Backspace/- Up one level │ │Ctrl-f FinOps │ │Esc/Alt-← Back │ │Alt-→ Forward │ │ │ │Global │ │: Command palette │ │r Refresh │ │Y Copy diagnostic │ │Ctrl-x Cancel running plugin │ │line 1-27 of 36 ▼ │ │j/k Scroll PgUp/PgDn Page g/G Top/Bottom Esc/? Close │ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
┌help───────────────────────────────────────── │Resources │Current view │v Toggle sidebar │Tab Focus sidebar │/ Filter │s Sort column │w Wide columns │←/→ Select column │j/k Move selection │Enter Open │Space Mark │V Range mark │\ Clear marks │U Unmark visible │t Start tunnel │L │J Related-resource jumps │, Run plugin │Backspace/- Up one level │Ctrl-f FinOps │Esc/Alt-← Back │Alt-→ Forward │ │Global │: Command palette │r Refresh │Y Copy diagnostic │Ctrl-x Cancel running plugin │line 1-27 of 36 ▼ │j/k Scroll PgUp/PgDn Page g/G Top/Bottom └─────────────────────────────────────────────
? lists the keys for the view you are in. Every key is on the Keys page.
Also in nuvem
- Key: lCloud Logging
- Read, tail and search the project's logs. In most services, L opens the logs of the selected resource.
- Key: tTunnels
- Start IAP, SSH or Cloud SQL Auth Proxy port forwards from a GCE instance or Cloud SQL row, and manage them from one list.
- Flag:
--read-onlyRead-only mode - Refuses every change to a cloud resource, and the SSH and k9s sessions that can make one.
- Key: ,Plugins
- Add your own gcloud commands to a service. They run against the selected row, after a confirmation that shows the whole command line.
Configurations, FinOps, related-resource jumps and themes are in the documentation, and the Keys page lists every key.
Sixteen services
Each one is a list you can sort, and seven open to more detail.
Compute and serverless
Data and storage
Messaging and networking
Identity and security
How it works
nuvem stores no credentials of its own. gcloud issues a short-lived token for the configuration you chose, and nuvem keeps it in memory. Before anything changes, a confirmation shows what is about to run.
Reads
Client librariesLists and details for every service but BigQuery, with a short-lived token that gcloud issues and nuvem keeps in memory.bq, gcloudBigQuery datasets and tables, budgets, and label-mode filters.
Confirmation
Shows what is about to run. Nothing runs until you confirm.
Changes, SSH, tunnels and sessions
Client librariesGCE and Cloud SQL lifecycle actions, with the same token. Shows the API call, such as compute.instances.stop.gcloudConfigurations, SSH, GCE tunnels and plugins. Shows the command line; for a new or edited configuration, the values it sets.cloud-sql-proxyCloud SQL tunnels. Shows the command line.k9sGKE clusters. Shows the k9s command, and the gcloud command that fetches credentials when one is needed.
Read more in Before a change runs, the questions about credentials and the security policy.
nuvem /ˈnu.vẽj/ noun, Portuguese: cloud.
Install
brew install filipeaaoliveira/tap/nuvem Every method, and what nuvem needs, is on the Install page.
Then run nuvem --demo to try it on sample data, with no account, or nuvem to open your active gcloud configuration.
nuvem is released under the MIT License. The source is on GitHub.
nuvem is an independent project, not affiliated with or endorsed by Google. Google Cloud is a trademark of Google LLC.