postgresai 0.11.0-alpha.9 → 0.12.0-alpha.14

package/README.md

@@ -6,6 +6,11 @@ Command-line interface for PostgresAI monitoring and database management.
 
 ### From npm
 
+```bash
+npm install -g postgresai
+```
+
+Or install the latest alpha release explicitly:
 ```bash
 npm install -g postgresai@alpha
 ```
@@ -47,7 +52,7 @@ This will:
 
 Start monitoring with demo database:
 ```bash
-postgres-ai quickstart --demo
+postgres-ai mon quickstart --demo
 ```
 
 This will:
@@ -57,27 +62,66 @@ This will:
 
 ## Commands
 
-### Monitoring services
+### Monitoring services management (`mon` group)
+
+#### Service lifecycle
+```bash
+postgres-ai mon quickstart [--demo]    # Complete setup (generate config, start services)
+postgres-ai mon start                  # Start monitoring services
+postgres-ai mon stop                   # Stop monitoring services
+postgres-ai mon restart [service]      # Restart all or specific monitoring service
+postgres-ai mon status                 # Show monitoring services status
+postgres-ai mon health [--wait <sec>]  # Check monitoring services health
+```
+
+#### Monitoring target databases (`mon targets` subgroup)
+```bash
+postgres-ai mon targets list                       # List databases to monitor
+postgres-ai mon targets add <conn-string> <name>   # Add database to monitor
+postgres-ai mon targets remove <name>              # Remove monitoring target
+postgres-ai mon targets test <name>                # Test target connectivity
+```
+
+#### Configuration and maintenance
 ```bash
-postgres-ai start              # Start all services
-postgres-ai stop               # Stop all services
-postgres-ai restart            # Restart all services
-postgres-ai status             # Show service status
-postgres-ai logs [service]     # Show logs
+postgres-ai mon config                         # Show monitoring configuration
+postgres-ai mon update-config                  # Apply configuration changes
+postgres-ai mon update                         # Update monitoring stack
+postgres-ai mon reset [service]                # Reset service data
+postgres-ai mon clean                          # Cleanup artifacts
+postgres-ai mon check                          # System readiness check
+postgres-ai mon shell <service>                # Open shell to monitoring service
 ```
 
-### Instance management
+### MCP server (`mcp` group)
+
 ```bash
-postgres-ai list-instances                          # List configured instances
-postgres-ai add-instance <conn-string> <name>       # Add new instance
-postgres-ai remove-instance <name>                  # Remove instance
-postgres-ai update-config                           # Regenerate config files
+pgai mcp start                 # Start MCP stdio server exposing list_issues tool
+```
+
+Cursor configuration example (Settings → MCP):
+
+```json
+{
+  "mcpServers": {
+    "PostgresAI": {
+      "command": "pgai",
+      "args": ["mcp", "start"],
+      "env": {
+        "PGAI_API_BASE_URL": "https://postgres.ai/api/general/"
+      }
+    }
+  }
+}
 ```
 
-### Configuration
+Tools exposed:
+- list_issues: returns the same JSON as `pgai issues list`.
+
+#### Grafana management
 ```bash
-postgres-ai config             # Show current configuration
-postgres-ai check              # Verify prerequisites
+postgres-ai mon generate-grafana-password      # Generate new Grafana password
+postgres-ai mon show-grafana-credentials       # Show Grafana credentials
 ```
 
 ### Authentication and API key management
@@ -103,6 +147,20 @@ API key resolution order:
 3. User config file (`~/.config/postgresai/config.json`)
 4. Legacy project config (`.pgwatch-config`)
 
+Base URL resolution order:
+- API base URL (`apiBaseUrl`):
+  1. Command line option (`--api-base-url`)
+  2. Environment variable (`PGAI_API_BASE_URL`)
+  3. User config file `baseUrl` (`~/.config/postgresai/config.json`)
+  4. Default: `https://postgres.ai/api/general/`
+- UI base URL (`uiBaseUrl`):
+  1. Command line option (`--ui-base-url`)
+  2. Environment variable (`PGAI_UI_BASE_URL`)
+  3. Default: `https://console.postgres.ai`
+
+Normalization:
+- A single trailing `/` is removed to ensure consistent path joining.
+
 ### Environment variables
 
 - `PGAI_API_KEY` - API key for PostgresAI services
@@ -120,7 +178,7 @@ Linux/macOS (bash/zsh):
 
 ```bash
 export PGAI_API_BASE_URL=https://v2.postgres.ai/api/general/
-export PGAI_UI_BASE_URL=https://console.postgres.ai
+export PGAI_UI_BASE_URL=https://console-dev.postgres.ai
 pgai auth --debug
 ```
 
@@ -128,7 +186,7 @@ Windows PowerShell:
 
 ```powershell
 $env:PGAI_API_BASE_URL = "https://v2.postgres.ai/api/general/"
-$env:PGAI_UI_BASE_URL = "https://console.postgres.ai"
+$env:PGAI_UI_BASE_URL = "https://console-dev.postgres.ai"
 pgai auth --debug
 ```
 
@@ -137,7 +195,7 @@ Via CLI options (overrides env):
 ```bash
 pgai auth --debug \
   --api-base-url https://v2.postgres.ai/api/general/ \
-  --ui-base-url https://console.postgres.ai
+  --ui-base-url https://console-dev.postgres.ai
 ```
 
 Notes: