docs: migrate from deprecated bash CLI to Node.js CLI

- Update README.md with `npm install -g postgresai` and `postgresai mon` commands
- Update CONTRIBUTING.md with Node.js CLI commands
- Update terraform/aws/README.md with Node.js CLI commands
- Update config/Dockerfile comment to reference `mon local-install --demo`
- Mark postgres_ai bash script as deprecated with warning message

The bash CLI is kept for backwards compatibility but shows a deprecation
warning on every invocation, directing users to use `postgresai mon` instead.

Author: claude

CONTRIBUTING.md

@@ -124,7 +124,7 @@ The demo DB is initialized by `config/target-db/init.sql` and creates the `monit
 PGPASSWORD='...' npx postgresai prepare-db postgresql://admin@host:5432/dbname
 ```
 
-- Add your instance to `instances.yml` (or use the helper CLI: `./postgres_ai add-instance 'postgresql://user:pass@host:port/db' my-db`)
+- Add your instance to `instances.yml` (or use the CLI: `postgresai mon targets add 'postgresql://user:pass@host:port/db' my-db`)
 - Make sure `is_enabled: true` for that instance.
 
 #### 2) Generate pgwatch sources from `instances.yml`
@@ -296,12 +296,12 @@ make up
 make up-local
 ```
 
-### Option A: Run via the `postgres_ai` script (recommended)
+### Option A: Run via the CLI (recommended)
 
-`postgres_ai` uses a single compose file path stored in `COMPOSE_FILE`. You can override it to include the local compose override:
+Use the CLI with `COMPOSE_FILE` to include the local compose override:
 
 ```bash
-COMPOSE_FILE="docker-compose.yml:docker-compose.local.yml" ./postgres_ai quickstart --demo -y
+COMPOSE_FILE="docker-compose.yml:docker-compose.local.yml" postgresai mon local-install --demo -y
 ```
 
 To rebuild on every run:
@@ -310,7 +310,7 @@ To rebuild on every run:
 COMPOSE_FILE="docker-compose.yml:docker-compose.local.yml" \
   docker compose -f docker-compose.yml -f docker-compose.local.yml build --no-cache
 
-COMPOSE_FILE="docker-compose.yml:docker-compose.local.yml" ./postgres_ai restart
+COMPOSE_FILE="docker-compose.yml:docker-compose.local.yml" postgresai mon restart
 ```
 
 ### Option B: Run Docker Compose directly
@@ -333,22 +333,22 @@ docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --force-r
 ### Reset everything
 
 ```bash
-./postgres_ai reset
+postgresai mon reset
 ```
 
 ### View logs
 
 ```bash
-./postgres_ai logs
-./postgres_ai logs grafana
-./postgres_ai logs monitoring_flask_backend
+postgresai mon logs
+postgresai mon logs grafana
+postgresai mon logs monitoring_flask_backend
 ```
 
 ### Stop / start
 
 ```bash
-./postgres_ai stop
-./postgres_ai start
+postgresai mon stop
+postgresai mon start
 ```
 
 

README.md

@@ -143,29 +143,29 @@ If you see errors like `permission denied` / `insufficient_privilege` / code `42
     npx postgresai prepare-db --print-sql -d mydb
     ```
 
-**One command setup:**
+**Install the CLI:**
 
 ```bash
-# Download the CLI
-curl -o postgres_ai https://gitlab.com/postgres-ai/postgres_ai/-/raw/main/postgres_ai \
-  && chmod +x postgres_ai
+npm install -g postgresai
 ```
 
-Now, start it and wait for a few minutes. To obtain a PostgresAI access token for your organization, visit https://console.postgres.ai (`Your org name → Manage → Access tokens`):
+**Start monitoring:**
+
+To obtain a PostgresAI access token for your organization, visit https://console.postgres.ai (`Your org name → Manage → Access tokens`):
 
 ```bash
 # Production setup with your Access token
-./postgres_ai quickstart --api-key=your_access_token
+postgresai mon local-install --api-key=your_access_token
 ```
 **Note:** You can also add your database instance in the same command:
 ```bash
-./postgres_ai quickstart --api-key=your_access_token --add-instance="postgresql://user:pass@host:port/DB"
+postgresai mon local-install --api-key=your_access_token --db-url="postgresql://user:pass@host:port/DB"
 ```
 
 Or if you want to just check out how it works:
 ```bash
 # Complete setup with demo database
-./postgres_ai quickstart --demo
+postgresai mon local-install --demo
 ```
 
 That's it! Everything is installed, configured, and running.
@@ -203,32 +203,32 @@ Failure to secure these ports may expose sensitive database information!
 
 **For developers:**
 ```bash
-./postgres_ai quickstart --demo
+postgresai mon local-install --demo
 ```
 Get a complete monitoring setup with demo data in under 2 minutes.
 
 **For production:**
 ```bash
-./postgres_ai quickstart --api-key=your_key
+postgresai mon local-install --api-key=your_key
 # Then add your databases
-./postgres_ai add-instance "postgresql://user:pass@host:port/DB"
+postgresai mon targets add "postgresql://user:pass@host:port/DB"
 ```
 
 ## 🔧 Management commands
 
 ```bash
 # Instance management
-./postgres_ai add-instance "postgresql://user:pass@host:port/DB"
-./postgres_ai list-instances
-./postgres_ai test-instance my-DB
+postgresai mon targets add "postgresql://user:pass@host:port/DB"
+postgresai mon targets list
+postgresai mon targets test my-DB
 
-# Service management  
-./postgres_ai status
-./postgres_ai logs
-./postgres_ai restart
+# Service management
+postgresai mon status
+postgresai mon logs
+postgresai mon restart
 
 # Health check
-./postgres_ai health
+postgresai mon health
 ```
 
 ## 📋 Checkup reports
@@ -295,9 +295,9 @@ postgres_ai monitoring generates automated health check reports based on [postgr
 
 ## 🌐 Access points
 
-After running quickstart:
+After running local-install:
 
-- **🚀 MAIN: Grafana Dashboard**: http://localhost:3000 (login: `monitoring`; password is shown at the end of quickstart)
+- **🚀 MAIN: Grafana Dashboard**: http://localhost:3000 (login: `monitoring`; password is shown at the end of local-install)
 
 Technical URLs (for advanced users):
 - **Demo DB**: postgresql://postgres:postgres@localhost:55432/target_database
@@ -307,27 +307,8 @@ Technical URLs (for advanced users):
 ## 📖 Help
 
 ```bash
-./postgres_ai help
-```
-
-### Node.js CLI (early preview)
-
-```bash
-# run without install
-node ./cli/bin/postgres-ai.js --help
-
-# local dev: install aliases into PATH
-npm --prefix cli install --no-audit --no-fund
-npm link ./cli
-postgres-ai --help
 postgresai --help
-pgai --help
-
-# or install globally after publish (planned)
-# npm i -g @postgresai/cli
-# postgres-ai --help
-# postgresai --help
-# pgai --help
+postgresai mon --help
 ```
 
 ## 🔑 PostgresAI access token

config/Dockerfile

@@ -25,7 +25,7 @@ COPY pgwatch-postgres/metrics.yml /postgres_ai_configs/pgwatch/metrics.yml
 COPY pgwatch-prometheus/metrics.yml /postgres_ai_configs/pgwatch-prometheus/metrics.yml
 COPY prometheus/ /postgres_ai_configs/prometheus/
 COPY sink-postgres/ /postgres_ai_configs/sink-postgres/
-# Demo DB – used only for `quickstart --demo`
+# Demo DB – used only for `mon local-install --demo`
 COPY target-db/ /postgres_ai_configs/target-db/
 
 # Copy infrastructure scripts (entrypoints, generators, etc.)

postgres_ai

@@ -1,10 +1,28 @@
 #!/bin/bash
 
-# Postgres AI CLI
+# ============================================================================
+# DEPRECATED: This bash CLI is deprecated and will be removed in a future release.
+# Please use the Node.js CLI instead:
+#
+#   npx postgresai mon local-install --demo    # Instead of: ./postgres_ai quickstart --demo
+#   npx postgresai mon targets add <url>       # Instead of: ./postgres_ai add-instance <url>
+#   npx postgresai mon targets list            # Instead of: ./postgres_ai list-instances
+#   npx postgresai mon status                  # Instead of: ./postgres_ai status
+#   npx postgresai mon --help                  # For all available commands
+#
+# See README.md for full documentation.
+# ============================================================================
+
+# Postgres AI CLI (DEPRECATED)
 # A CLI tool for managing the PostgreSQL monitoring system with Docker Compose
 
 set -e
 
+# Show deprecation warning on every invocation
+echo "⚠️  WARNING: This bash CLI is deprecated. Please use 'npx postgresai mon' instead." >&2
+echo "   See: npx postgresai mon --help" >&2
+echo "" >&2
+
 # Configuration
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_NAME="postgres-ai-mon"

terraform/aws/README.md

@@ -179,7 +179,7 @@ Method 2: Manual configuration (avoids credentials in state):
 ssh ubuntu@your-ip
 cd /home/postgres_ai/postgres_ai
 sudo -u postgres_ai vim instances.yml
-sudo -u postgres_ai ./postgres_ai update-config
+sudo -u postgres_ai postgresai mon update-config
 ```
 
 ### Backup