@runtypelabs/cli 0.1.9 → 0.1.10

package/README.md

@@ -132,17 +132,22 @@ node dist/index.js talk
 **Option 3: Install globally for testing**
 
 ```bash
-# Build and install globally
+# Build first
 pnpm build
-npm install -g .
 
+# Option A: Symlink (pnpm) — global runtype uses your local package; rebuild after changes
+# If you get "Unable to find the global bin directory", run: pnpm setup (then restart terminal)
+pnpm link --global
+# Use anywhere: runtype --help, runtype products init --from <url>, etc.
+# To stop: pnpm unlink --global (from packages/cli)
+
+# Option B: Install current directory (npm)
+npm install -g .
 # Now use the runtype command anywhere
 runtype --help
 runtype auth login
 runtype talk
-
-# After making changes, rebuild and reinstall
-pnpm build && npm install -g .
+# After making changes, rebuild and reinstall: pnpm build && npm install -g .
 ```
 
 ### Local Environment Configuration
@@ -163,6 +168,33 @@ RUNTYPE_DEFAULT_TEMPERATURE=0.7
 DEBUG=true
 ```
 
+### Testing against local API
+
+To use the CLI with your local API and dashboard:
+
+1. **Run API and dashboard** (from repo root): `pnpm dev:api` (or `pnpm dev:bun`) and `pnpm dev:dashboard`. Ensure the dashboard has `NEXT_PUBLIC_RUNTYPE_API_URL=http://localhost:8787` so CLI auth creates keys against your local API.
+
+2. **Use a `.env` in `packages/cli`** with `RUNTYPE_API_URL` and `RUNTYPE_DASHBOARD_URL` as above, or set them when running:
+
+   ```bash
+   RUNTYPE_DASHBOARD_URL=http://localhost:3001 RUNTYPE_API_URL=http://localhost:8787 pnpm dev -- auth login
+   ```
+
+3. **Or skip browser auth** by creating an API key in the local dashboard, then:
+   ```bash
+   RUNTYPE_API_URL=http://localhost:8787 pnpm dev -- auth login --api-key YOUR_API_KEY
+   ```
+
+**Testing a single command** (from `packages/cli`):
+
+```bash
+export RUNTYPE_DASHBOARD_URL=http://localhost:3001
+export RUNTYPE_API_URL=http://localhost:8787
+pnpm dev -- agents list
+```
+
+Or inline: `RUNTYPE_DASHBOARD_URL=http://localhost:3001 RUNTYPE_API_URL=http://localhost:8787 pnpm dev -- flows list`
+
 ### Testing
 
 ```bash
@@ -175,7 +207,7 @@ pnpm test:watch
 
 ## Environment Variables
 
-- `RUNTYPE_API_URL` - API endpoint URL (default: https://api.runtype.com)
+- `RUNTYPE_API_URL` - API base URL **without** a path (e.g. `http://localhost:8787`). Do not include `/v1`; the CLI adds the version prefix. Default: https://api.runtype.com
 - `RUNTYPE_DASHBOARD_URL` - Dashboard URL (default: https://use.runtype.com)
 - `CLERK_PUBLISHABLE_KEY` - Clerk public key for OAuth
 - `RUNTYPE_DEFAULT_MODEL` - Default AI model (default: gpt-4o)