@insforge/cli 0.1.87 → 0.1.88-razorpay.0

package/README.md

@@ -72,6 +72,11 @@ All commands support the following flags:
 
 ## Commands
 
+> The `orgs`, `projects`, and `records` command groups are registered but hidden
+> (`hidden: true` in `src/index.ts`) and are intentionally excluded from this
+> reference. Use `npx @insforge/cli list` instead of `orgs`/`projects`; `records`
+> is internal and not supported for direct use.
+
 ### Top-Level
 
 #### `npx @insforge/cli whoami`
@@ -99,8 +104,19 @@ Create a new InsForge project interactively.
 ```bash
 npx @insforge/cli create
 npx @insforge/cli create --name "my-app" --org-id <org-id> --region us-east
+npx @insforge/cli create --name "my-app" --template nextjs --auth better-auth   # scaffold from a built-in template
+npx @insforge/cli create --name "my-app" --marketplace <slug>                   # install a marketplace template
 ```
 
+**Options:**
+
+- `--name <name>`: Project name
+- `--org-id <id>`: Organization ID
+- `--region <region>`: Deployment region (`us-east`, `us-west`, `eu-central`, `ap-southeast`)
+- `--template <template>`: Built-in template (`react`, `nextjs`, `chatbot`, `crm`, `e-commerce`, `todo`, or `empty`)
+- `--marketplace <slug>`: Install a marketplace template by slug (browse: https://insforge.dev/templates)
+- `--auth <provider>`: Wire a third-party auth provider into the chosen template (currently: `better-auth`)
+
 #### `npx @insforge/cli link`
 
 Link the current directory to an InsForge project. Creates `.insforge/project.json` with the project ID, API key, and OSS host URL.
@@ -186,6 +202,66 @@ npx @insforge/cli docs storage rest-api       # Show REST API storage docs
 
 ---
 
+### Branch — `npx @insforge/cli branch`
+
+Manage backend branches of the currently linked project.
+
+#### `npx @insforge/cli branch list`
+
+List branches of the currently linked project.
+
+```bash
+npx @insforge/cli branch list
+npx @insforge/cli branch list --json
+```
+
+#### `npx @insforge/cli branch create <name>`
+
+Create a branch from the currently linked project.
+
+```bash
+npx @insforge/cli branch create feature-x
+npx @insforge/cli branch create feature-x --mode schema-only   # full | schema-only (default: full)
+npx @insforge/cli branch create feature-x --no-switch          # do not auto-switch context after creation
+```
+
+#### `npx @insforge/cli branch switch [name]`
+
+Switch this directory's context to a branch (or back to the parent project).
+
+```bash
+npx @insforge/cli branch switch feature-x
+npx @insforge/cli branch switch --parent   # switch back to the parent project
+```
+
+#### `npx @insforge/cli branch merge <name>`
+
+Merge a branch back to its parent project.
+
+```bash
+npx @insforge/cli branch merge feature-x
+npx @insforge/cli branch merge feature-x --dry-run            # compute the diff and print rendered SQL; do not apply
+npx @insforge/cli branch merge feature-x --save-sql diff.sql  # write rendered SQL preview to a file
+```
+
+#### `npx @insforge/cli branch reset <name>`
+
+Reset a branch's database back to T0 (the parent snapshot at branch creation).
+
+```bash
+npx @insforge/cli branch reset feature-x
+```
+
+#### `npx @insforge/cli branch delete <name>`
+
+Delete a branch.
+
+```bash
+npx @insforge/cli branch delete feature-x
+```
+
+---
+
 ### AI — `npx @insforge/cli ai`
 
 Configure local development for the InsForge Model Gateway. The setup command fetches the linked project's active OpenRouter key from the InsForge backend and writes it as the server-only `OPENROUTER_API_KEY` variable.
@@ -278,6 +354,26 @@ Import database from a local SQL file.
 npx @insforge/cli db import schema.sql
 ```
 
+#### `npx @insforge/cli db migrations`
+
+Manage database migration files.
+
+```bash
+npx @insforge/cli db migrations list          # list applied remote migrations
+npx @insforge/cli db migrations fetch         # fetch applied remote migrations into migrations/
+npx @insforge/cli db migrations new add-users # create a new local migration file (lowercase, digits, hyphens only)
+npx @insforge/cli db migrations up --all      # apply all pending local migrations
+npx @insforge/cli db migrations up --to 20260101_add-users  # apply up to a version/file
+```
+
+#### `npx @insforge/cli db connection-string`
+
+Print the project Postgres connection URL (cloud projects only).
+
+```bash
+npx @insforge/cli db connection-string
+```
+
 ---
 
 ### Functions — `npx @insforge/cli functions`
@@ -426,108 +522,150 @@ Cancel a running deployment.
 npx @insforge/cli deployments cancel abc-123
 ```
 
+#### `npx @insforge/cli deployments env`
+
+Manage deployment environment variables.
+
+```bash
+npx @insforge/cli deployments env list                       # list all deployment env vars
+npx @insforge/cli deployments env set API_URL https://api.example.com  # create or update a variable
+npx @insforge/cli deployments env delete <id>                # delete a variable by ID
+```
+
 ---
 
 ### Payments — `npx @insforge/cli payments`
 
-Manage the Stripe payments foundation for the linked InsForge project. These commands are intended for developers and agents configuring Stripe keys, syncing catalog state, inspecting mirrored customers, and managing products/prices. Runtime checkout and customer portal calls should usually be made from the app via the SDK.
+Manage the payments foundation for the linked InsForge project. Provider-specific commands live under `payments stripe` and `payments razorpay`. These commands are intended for developers and agents configuring provider keys, syncing mirrored provider state, inspecting customers, and managing provider catalog records. Runtime checkout/order/subscription calls should usually be made from the app via the SDK.
 
-#### `npx @insforge/cli payments status`
+#### `npx @insforge/cli payments <provider> status`
 
-Show Stripe key, account, sync, and webhook status for test/live environments.
+Show key, account, sync, and webhook status for test/live environments.
 
 ```bash
-npx @insforge/cli payments status
-npx @insforge/cli payments status --json
+npx @insforge/cli payments stripe status
+npx @insforge/cli payments razorpay status
+npx @insforge/cli payments stripe status --json
 ```
 
-#### `npx @insforge/cli payments config`
+#### `npx @insforge/cli payments <provider> config`
 
-List, set, or remove Stripe secret keys.
+List, set, or remove provider keys.
 
 ```bash
-npx @insforge/cli payments config
-npx @insforge/cli payments config set test sk_test_xxx
-npx @insforge/cli payments config set live        # prompts securely
-npx @insforge/cli payments config remove test -y
+npx @insforge/cli payments stripe config list
+npx @insforge/cli payments stripe config set --environment test sk_test_xxx
+npx @insforge/cli payments stripe config set --environment live        # prompts securely
+npx @insforge/cli payments stripe config remove --environment test -y
+npx @insforge/cli payments razorpay config list
+npx @insforge/cli payments razorpay config set --environment test --key-id rzp_test_xxx --key-secret xxx
+npx @insforge/cli payments razorpay config remove --environment test -y
 ```
 
-#### `npx @insforge/cli payments sync`
+#### `npx @insforge/cli payments <provider> sync`
 
-Sync Stripe products, prices, customers, and subscriptions from configured environments.
+Sync provider catalog, customers, subscriptions, and transaction projections from configured environments.
 
 ```bash
-npx @insforge/cli payments sync
-npx @insforge/cli payments sync --environment test
-npx @insforge/cli payments sync --environment live --json
+npx @insforge/cli payments stripe sync
+npx @insforge/cli payments stripe sync --environment test
+npx @insforge/cli payments razorpay sync --environment test
+npx @insforge/cli payments stripe sync --environment live --json
 ```
 
-#### `npx @insforge/cli payments webhooks configure <environment>`
+#### `npx @insforge/cli payments stripe webhooks configure --environment <environment>`
 
 Create or recreate the InsForge-managed Stripe webhook endpoint for an environment.
 
 ```bash
-npx @insforge/cli payments webhooks configure test
+npx @insforge/cli payments stripe webhooks configure --environment test
 ```
 
-#### `npx @insforge/cli payments catalog --environment <environment>`
+#### Razorpay webhook setup
 
-Inspect mirrored Stripe products and prices for one environment.
+Razorpay webhooks are configured manually in the Razorpay dashboard. Use the InsForge dashboard payments settings dialog to copy the webhook URL and webhook secret, then select the recommended events on Razorpay's website.
+
+#### `npx @insforge/cli payments <provider> catalog --environment <environment>`
+
+Inspect mirrored provider catalog records for one environment.
 
 ```bash
-npx @insforge/cli payments catalog --environment test
-npx @insforge/cli payments catalog --environment test --json
+npx @insforge/cli payments stripe catalog --environment test
+npx @insforge/cli payments razorpay catalog --environment test
+npx @insforge/cli payments stripe catalog --environment test --json
 ```
 
-#### `npx @insforge/cli payments customers --environment <environment>`
+#### `npx @insforge/cli payments <provider> customers --environment <environment>`
 
-List mirrored Stripe customers for admin/debugging workflows.
+List mirrored provider customers for admin/debugging workflows.
 
 ```bash
-npx @insforge/cli payments customers --environment test
-npx @insforge/cli payments customers --environment test --limit 20 --json
+npx @insforge/cli payments stripe customers --environment test
+npx @insforge/cli payments razorpay customers --environment test
+npx @insforge/cli payments stripe customers --environment test --limit 20 --json
 ```
 
-#### `npx @insforge/cli payments products`
+#### `npx @insforge/cli payments stripe products`
 
 List, inspect, create, update, or delete Stripe products.
 
 ```bash
-npx @insforge/cli payments products list --environment test
-npx @insforge/cli payments products get prod_123 --environment test
-npx @insforge/cli payments products create --environment test --name "Pro Plan"
-npx @insforge/cli payments products update prod_123 --environment test --description "Updated"
-npx @insforge/cli payments products delete prod_123 --environment test -y
+npx @insforge/cli payments stripe products list --environment test
+npx @insforge/cli payments stripe products get prod_123 --environment test
+npx @insforge/cli payments stripe products create --environment test --name "Pro Plan"
+npx @insforge/cli payments stripe products update prod_123 --environment test --description "Updated"
+npx @insforge/cli payments stripe products delete prod_123 --environment test -y
 ```
 
-#### `npx @insforge/cli payments prices`
+#### `npx @insforge/cli payments stripe prices`
 
 List, inspect, create, update, or archive Stripe prices.
 
 ```bash
-npx @insforge/cli payments prices list --environment test
-npx @insforge/cli payments prices create --environment test --product prod_123 --currency usd --unit-amount 2000
-npx @insforge/cli payments prices create --environment test --product prod_123 --currency usd --unit-amount 2000 --interval month
-npx @insforge/cli payments prices update price_123 --environment test --active false
-npx @insforge/cli payments prices archive price_123 --environment test
+npx @insforge/cli payments stripe prices list --environment test
+npx @insforge/cli payments stripe prices create --environment test --product prod_123 --currency usd --unit-amount 2000
+npx @insforge/cli payments stripe prices create --environment test --product prod_123 --currency usd --unit-amount 2000 --interval month
+npx @insforge/cli payments stripe prices update price_123 --environment test --active false
+npx @insforge/cli payments stripe prices archive price_123 --environment test
+```
+
+#### `npx @insforge/cli payments razorpay items`
+
+List, create, or update Razorpay items.
+
+```bash
+npx @insforge/cli payments razorpay items list --environment test
+npx @insforge/cli payments razorpay items create --environment test --name "Pro Plan" --amount 200000 --currency inr
+npx @insforge/cli payments razorpay items update item_123 --environment test --active false
 ```
 
-#### `npx @insforge/cli payments subscriptions`
+#### `npx @insforge/cli payments razorpay plans`
 
-List mirrored Stripe subscriptions for admin/debugging workflows.
+List or create Razorpay subscription plans.
 
 ```bash
-npx @insforge/cli payments subscriptions --environment test
-npx @insforge/cli payments subscriptions --environment test --subject-type team --subject-id team_123
+npx @insforge/cli payments razorpay plans list --environment test
+npx @insforge/cli payments razorpay plans create --environment test --period monthly --interval 1 --item-name "Pro Plan" --item-amount 200000 --item-currency inr
 ```
 
-#### `npx @insforge/cli payments history`
+#### `npx @insforge/cli payments <provider> subscriptions --environment <environment>`
 
-List mirrored payment history for admin/debugging workflows.
+List mirrored provider subscriptions for admin/debugging workflows.
 
 ```bash
-npx @insforge/cli payments history --environment test
-npx @insforge/cli payments history --environment test --limit 20 --json
+npx @insforge/cli payments stripe subscriptions --environment test
+npx @insforge/cli payments razorpay subscriptions --environment test
+npx @insforge/cli payments stripe subscriptions --environment test --subject-type team --subject-id team_123
+```
+
+#### `npx @insforge/cli payments <provider> transactions --environment <environment>`
+
+List mirrored payment transactions for admin/debugging workflows. `--subject-type` and `--subject-id` refer to the app billing subject passed to InsForge, such as `team:team_123` or `user:user_123`; they are not provider customer, payment, order, or subscription ids.
+
+```bash
+npx @insforge/cli payments stripe transactions --environment test
+npx @insforge/cli payments razorpay transactions --environment test
+npx @insforge/cli payments stripe transactions --environment test --limit 20 --json
 ```
 
 ---
@@ -643,6 +781,194 @@ npx @insforge/cli schedules logs 123 --limit 100
 
 ---
 
+### Compute — `npx @insforge/cli compute`
+
+Manage compute services (Docker containers on Fly.io).
+
+#### `npx @insforge/cli compute list`
+
+List all compute services.
+
+```bash
+npx @insforge/cli compute list
+```
+
+#### `npx @insforge/cli compute get <id>`
+
+Get details of a compute service.
+
+```bash
+npx @insforge/cli compute get my-api
+```
+
+#### `npx @insforge/cli compute deploy [dir]`
+
+Deploy a compute service. Source mode runs a `flyctl` remote build and push (requires `flyctl` on PATH, no Docker needed); image mode deploys a pre-built image (no `flyctl`/Docker required).
+
+```bash
+# Source mode
+npx @insforge/cli compute deploy ./api --name my-api
+# Image mode
+npx @insforge/cli compute deploy --image registry.example.com/my-api:latest --name my-api
+# Common options
+npx @insforge/cli compute deploy ./api --name my-api \
+  --port 8080 --cpu shared-1x --memory 512 --region iad \
+  --env '{"LOG_LEVEL":"info"}'        # or --env-file .env
+```
+
+**Options:**
+
+- `--name <name>`: Service name (required)
+- `--image <url>`: Container image URL (image mode)
+- `--port <port>`: Container port (default: `8080`)
+- `--cpu <tier>`: CPU tier (default: `shared-1x`)
+- `--memory <mb>`: Memory in MB (default: `512`)
+- `--region <region>`: Deploy region (default: `iad`)
+- `--env <json>`: Environment variables as JSON
+- `--env-file <path>`: Load environment variables from a file
+- `--protocol <http|tcp>`: Service protocol (default: `http`)
+
+#### `npx @insforge/cli compute update <id>`
+
+Update a compute service.
+
+```bash
+npx @insforge/cli compute update my-api --memory 1024
+npx @insforge/cli compute update my-api --env-set LOG_LEVEL=debug   # set/update one var (repeatable)
+npx @insforge/cli compute update my-api --env-unset OLD_KEY         # remove one var (repeatable)
+```
+
+**Options:**
+
+- `--image <image>`: Container image URL
+- `--port <port>`: Container port
+- `--cpu <tier>`: CPU tier
+- `--memory <mb>`: Memory in MB
+- `--region <region>`: Deploy region
+- `--env <json>`: Environment variables as JSON (replaces ALL vars)
+- `--env-set <KEY=VALUE>`: Set/update one variable (repeatable, merges)
+- `--env-unset <KEY>`: Remove one variable (repeatable, merges)
+
+#### `npx @insforge/cli compute start <id>` / `stop <id>`
+
+Start a stopped, or stop a running, compute service.
+
+```bash
+npx @insforge/cli compute start my-api
+npx @insforge/cli compute stop my-api
+```
+
+#### `npx @insforge/cli compute events <id>`
+
+Get compute service machine events (start/stop/exit/restart).
+
+```bash
+npx @insforge/cli compute events my-api --limit 50
+```
+
+#### `npx @insforge/cli compute delete <id>`
+
+Delete a compute service and its Fly.io resources.
+
+```bash
+npx @insforge/cli compute delete my-api
+```
+
+---
+
+### Diagnose — `npx @insforge/cli diagnose`
+
+Backend diagnostics. Run with no subcommand for a full health report.
+
+```bash
+npx @insforge/cli diagnose
+npx @insforge/cli diagnose --ai "why is my database slow?"   # ask AI to analyze diagnostic data
+```
+
+#### `npx @insforge/cli diagnose advisor`
+
+Display latest advisor scan results and issues.
+
+```bash
+npx @insforge/cli diagnose advisor --severity critical --category security --limit 50
+```
+
+#### `npx @insforge/cli diagnose db`
+
+Run database health checks (connections, bloat, index usage, etc.).
+
+```bash
+npx @insforge/cli diagnose db
+npx @insforge/cli diagnose db --check connections,bloat
+```
+
+#### `npx @insforge/cli diagnose logs`
+
+Aggregate error-level logs from all backend sources.
+
+```bash
+npx @insforge/cli diagnose logs --source postgres.logs --limit 100
+```
+
+#### `npx @insforge/cli diagnose metrics`
+
+Display EC2 instance metrics (CPU, memory, disk, network).
+
+```bash
+npx @insforge/cli diagnose metrics --range 6h
+```
+
+---
+
+### PostHog — `npx @insforge/cli posthog`
+
+Manage PostHog product analytics integration.
+
+#### `npx @insforge/cli posthog setup`
+
+Connect PostHog to your InsForge dashboard, then run the official PostHog wizard to wire it into your app.
+
+```bash
+npx @insforge/cli posthog setup
+npx @insforge/cli posthog setup --skip-browser   # only print the OAuth URL, do not auto-open the browser
+```
+
+---
+
+### Config — `npx @insforge/cli config`
+
+Manage `insforge.toml` (declarative project configuration).
+
+#### `npx @insforge/cli config export`
+
+Pull live project config and write `insforge.toml`.
+
+```bash
+npx @insforge/cli config export
+npx @insforge/cli config export --out insforge.toml --force
+```
+
+#### `npx @insforge/cli config plan`
+
+Show the diff between `insforge.toml` and live project state.
+
+```bash
+npx @insforge/cli config plan
+npx @insforge/cli config plan --file insforge.toml
+```
+
+#### `npx @insforge/cli config apply`
+
+Apply `insforge.toml` to the live project.
+
+```bash
+npx @insforge/cli config apply
+npx @insforge/cli config apply --dry-run        # show plan, do not apply
+npx @insforge/cli config apply --auto-approve   # skip confirmation prompt
+```
+
+---
+
 ## Project Configuration
 
 Running `npx @insforge/cli link` creates a `.insforge/` directory in your project: