@ranger-testing/ranger-cli 1.1.7 → 2.0.0

package/README.md

@@ -1,7 +1,9 @@
-# Ranger CLI
+# Ranger Feature Review CLI
 
 Ranger brings automated QA to agentic development. The CLI sets up your project so your AI coding agent can verify UI features in a real browser, and your team can review the results on a shared dashboard.
 
+https://docs.ranger.net/getting-started/quickstart/
+
 ## Getting Started
 
 ### 1. Install
@@ -15,7 +17,7 @@ npm install -g @ranger-testing/ranger-cli
 From your project root (must be a git repo):
 
 ```bash
-ranger start
+ranger setup
 ```
 
 This walks you through everything interactively:
@@ -23,10 +25,10 @@ This walks you through everything interactively:
 - **Authentication** -- opens your browser to log in (credentials stored in OS Keychain)
 - **Chromium** -- installs the browser used for verification
 - **Plugin** -- installs the Claude Code plugin (you choose user-level or project-level)
-- **Environment** -- prompts for your app's URL, opens a browser to capture login session
+- **Profile** -- prompts for your app's URL, opens a browser to capture login session
 - **Skills** -- installs markdown files that teach Claude the Ranger workflow
 
-> For CI, pass a token directly: `ranger start <token>`. See `RANGER_MCP_TOKEN` env var for non-interactive use.
+> For CI, pass a token directly: `ranger setup [token]`. See `RANGER_MCP_TOKEN` env var for non-interactive use.
 
 ### 3. Use Ranger in Claude Code
 
@@ -34,13 +36,13 @@ This walks you through everything interactively:
 /ranger:enable
 ```
 
-Ask Claude to build a UI feature. Ranger handles the rest: creating a feature, verifying it in the browser, and sharing a review link when it's done.
+Ask Claude to build a UI feature. Ranger handles the rest: creating a feature review, verifying it in the browser, and sharing a review link when it's done.
 
 ## How It Works
 
-1. Claude creates a **feature** with checklist items describing what to verify
+1. Claude creates a **feature review** with scenarios describing what to verify
 2. Claude implements the code
-3. Claude runs `ranger verify-feature` -- a browser agent tests the feature against your running app
+3. Claude runs `ranger go` -- a browser agent tests the feature review scenarios against your running app
 4. If something's broken, Claude fixes it and re-verifies
 5. Once verified, you review the evidence (screenshots, video) on the [dashboard](https://dashboard.ranger.net)
 6. Leave comments or approve -- like a GitHub PR, but for UI
@@ -51,57 +53,57 @@ Ask Claude to build a UI feature. Ranger handles the rest: creating a feature, v
 
 | Command         | Description                                                         |
 | --------------- | ------------------------------------------------------------------- |
-| `ranger start`  | Full interactive setup (auth, browser, plugin, environment, skills) |
+| `ranger setup`  | Full interactive setup (auth, browser, plugin, skills, profile)     |
 | `ranger login`  | Re-authenticate without running full setup                          |
-| `ranger status` | Show version, org, plugin, skills, and environment status           |
+| `ranger status` | Show version, org, plugin, skills, and profile status               |
 | `ranger update` | Update CLI to latest version and refresh skills                     |
 | `ranger clean`  | Remove all Ranger artifacts from the project                        |
 
-### Environments
-
-| Command                     | Description                                               |
-| --------------------------- | --------------------------------------------------------- |
-| `ranger add env <name>`     | Add a browser environment (opens browser to capture auth) |
-| `ranger use <name>`         | Switch active environment                                 |
-| `ranger env ls`             | List all environments                                     |
-| `ranger env update <name>`  | Re-capture auth for an environment                        |
-| `ranger auth encrypt <env>` | Encrypt auth.json for safe git storage (CI)               |
-
-### Features
-
-| Command                                      | Description                                                       |
-| -------------------------------------------- | ----------------------------------------------------------------- |
-| `ranger feature create "<name>"`             | Create a feature (`-d` for description, `-c` for checklist items) |
-| `ranger feature list`                        | List features (`--current-branch` to filter by branch)            |
-| `ranger feature show`                        | Show active feature status and checklist                          |
-| `ranger feature resume <id>`                 | Set a feature as active and start its session                     |
-| `ranger feature add-checklist-item "<desc>"` | Add a checklist item to the active feature                        |
-| `ranger feature get-feedback`                | Show unaddressed reviewer comments                                |
-| `ranger feature sessions`                    | List sessions for the active feature                              |
-| `ranger feature conclude-session`            | End the current session                                           |
+### Profiles
+
+| Command                               | Description                                           |
+| ------------------------------------- | ----------------------------------------------------- |
+| `ranger profile add <name>`           | Add a browser profile (opens browser to capture auth) |
+| `ranger profile use <name>`           | Switch active profile                                 |
+| `ranger profile ls`                   | List all profiles                                     |
+| `ranger profile update <name>`        | Re-capture auth for a profile                         |
+| `ranger profile encrypt-auth <name>`  | Encrypt auth.json for safe git storage (CI)           |
+
+### Feature Reviews
+
+| Command                     | Description                                                    |
+| --------------------------- | -------------------------------------------------------------- |
+| `ranger create "<name>"`    | Create a feature review (`-d` for description, `-c` for scenarios) |
+| `ranger list`               | List feature reviews (`--current-branch` to filter by branch)  |
+| `ranger show`               | Show active feature review status and scenarios                |
+| `ranger resume <id>`        | Set a feature review as active and start its session           |
+| `ranger add-scenario "<desc>"` | Add a scenario to the active feature review                 |
+| `ranger get-review`         | Show unaddressed reviewer comments                             |
+| `ranger delete`             | Soft delete the active feature review                          |
+| `ranger restore <id>`       | Restore a soft-deleted feature review                          |
 
 ### Verification
 
-| Command                 | Description                            |
-| ----------------------- | -------------------------------------- |
-| `ranger verify-feature` | Verify a checklist item in the browser |
+| Command      | Description                          |
+| ------------ | ------------------------------------ |
+| `ranger go`  | Verify a scenario in the browser     |
 
-Options: `--item <N>` (item index), `--task "<desc>"` (override task), `--start-path /path` (start URL), `--env <name>`.
+Options: `--scenario <N>` (scenario index), `--notes "<desc>"` (override notes), `--start-path /path` (start URL), `--profile <name>`.
 
 ### Config
 
-| Command                                 | Description                        |
-| --------------------------------------- | ---------------------------------- |
-| `ranger config set <env> <key> <value>` | Set a config value                 |
-| `ranger config get <env> <key>`         | Read a config value                |
-| `ranger config list <env>`              | Show all config for an environment |
-| `ranger config unset <env> <key>`       | Remove a config value              |
+| Command                                           | Description                    |
+| ------------------------------------------------- | ------------------------------ |
+| `ranger profile config set <profile> <key> <value>` | Set a config value           |
+| `ranger profile config get <profile> <key>`         | Read a config value          |
+| `ranger profile config list <profile>`              | Show all config for a profile |
+| `ranger profile config unset <profile> <key>`       | Remove a config value         |
 
 Keys: `headless`, `userAgent`, `storageState`, `header.<name>`. Environment variables (e.g., `${AUTH_TOKEN}`) are resolved at runtime.
 
 ## Plugin
 
-`ranger start` installs the Claude Code plugin automatically. To install manually:
+`ranger setup` installs the Claude Code plugin automatically. To install manually:
 
 ```bash
 claude plugin marketplace add ranger-testing/trailhead
@@ -110,10 +112,10 @@ claude plugin install ranger@trailhead --scope user
 
 ## Troubleshooting
 
-**"No active environment"** -- Run `ranger use <env-name>`.
+**"No active profile"** -- Run `ranger profile use <profile-name>`.
 
-**Authentication expired** -- Run `ranger env update <env-name>` to re-capture.
+**Authentication expired** -- Run `ranger profile update <profile-name>` to re-capture.
 
-**"No active feature"** -- Run `ranger feature list` then `ranger feature resume <id>`.
+**"No active feature review"** -- Run `ranger list` then `ranger resume <id>`.
 
 Run `ranger status` to see everything at a glance.