gcp-cleaner/README.md

GCP Project Cleaner

A simple CLI tool to bulk delete GCP projects.

Prerequisites

• Node.js (v18 or higher)
• pnpm
• Google Cloud SDK (gcloud) authenticated with gcloud auth login.

Usage

1. Install dependencies:

   pnpm install
   

2. Run the script:

   pnpm start
   

Features

• Authentication Check: Verifies if you are authenticated with gcloud.
• Interactive Selection: Choose multiple projects to delete using an interactive checkbox list.
• Project Age Highlighting: Projects are color-coded based on their age (Green: <30 days, Yellow: >30 days, Red: >1 year).
• Safe Confirmation: Requires explicit confirmation before any deletion occurs.
• Bulk Execution: Deletes selected projects sequentially and logs the status.

Note on Deletion

GCP projects are usually "scheduled for deletion" and remain in a "Pending Deletion" state for 30 days before being permanently removed. You can restore them within this period if needed.