postgresai 0.11.0-alpha.1 → 0.11.0-alpha.3

package/README.md

@@ -1,31 +1,76 @@
-## CLI developer quickstart
+# PostgresAI CLI
+
+Command-line interface for PostgresAI monitoring and database management.
+
+## Installation
 
-### run without install
 ```bash
-npm --prefix cli install --no-audit --no-fund
-node ./cli/bin/postgres-ai.js --help
+npm install -g postgresai@alpha
 ```
 
-### use aliases locally (no ./)
+## Usage
+
+The CLI provides two command aliases:
 ```bash
-# install from repo into global prefix
-npm install -g ./cli
+postgres-ai --help
+pgai --help  # short alias
+```
 
-# ensure global npm bin is in PATH (zsh)
-echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
-exec zsh -l
+## Quick start
 
-# aliases
-postgres-ai --help
-pgai --help
+Start monitoring with demo database:
+```bash
+postgres-ai quickstart --demo
+```
+
+This will:
+- Generate secure Grafana password
+- Start all monitoring services
+- Open Grafana at http://localhost:3000
+
+## Commands
+
+### Monitoring services
+```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
+```
+
+### Instance management
+```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
 ```
 
-### one‑off run (no install)
+### Configuration
 ```bash
-npx -y -p file:cli postgres-ai --help
+postgres-ai config             # Show current configuration
+postgres-ai check              # Verify prerequisites
 ```
 
-### env vars for integration tests
-- `PGAI_API_KEY`
-- `PGAI_BASE_URL` (default `https://v2.postgres.ai/api/general/`)
+### API key management
+```bash
+postgres-ai add-key <key>      # Store API key
+postgres-ai show-key           # Show stored key (masked)
+postgres-ai remove-key         # Remove stored key
+```
+
+## Environment variables
+
+- `PGAI_API_KEY` - API key for PostgresAI services
+- `PGAI_BASE_URL` - API endpoint (default: `https://postgres.ai/api/general/`)
+
+## Requirements
+
+- Node.js 18 or higher
+- Docker and Docker Compose
+
+## Learn more
 
+- Documentation: https://postgres.ai/docs
+- Issues: https://gitlab.com/postgres-ai/postgres_ai/-/issues

package/bin/postgres-ai.js

@@ -7,7 +7,7 @@ const pkg = require("../package.json");
 function getConfig(opts) {
   const apiKey = opts.apiKey || process.env.PGAI_API_KEY || "";
   const baseUrl =
-    opts.baseUrl || process.env.PGAI_BASE_URL || "https://v2.postgres.ai/api/general/";
+    opts.baseUrl || process.env.PGAI_BASE_URL || "https://postgres.ai/api/general/";
   return { apiKey, baseUrl };
 }
 
@@ -21,7 +21,7 @@ program
   .option(
     "--base-url <url>",
     "API base URL (overrides PGAI_BASE_URL)",
-    "https://v2.postgres.ai/api/general/"
+    "https://postgres.ai/api/general/"
   );
 
 const stub = (name) => async () => {
@@ -199,6 +199,12 @@ program
       const list = filtered.length > 0 ? filtered : [];
       if (list.length === 0) {
         console.log("No instances configured");
+        console.log("");
+        console.log("To add an instance:");
+        console.log("  postgres-ai add-instance <connection-string> <name>");
+        console.log("");
+        console.log("Example:");
+        console.log("  postgres-ai add-instance 'postgresql://user:pass@host:5432/db' my-db");
         return;
       }
       for (const n of list) console.log(`Instance: ${n}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresai",
-  "version": "0.11.0-alpha.1",
+  "version": "0.11.0-alpha.3",
   "description": "PostgresAI CLI (Node.js)",
   "license": "MIT",
   "private": false,