@ranger-testing/ranger-cli 1.0.13 → 1.0.14

package/README.md

@@ -10,34 +10,29 @@ npm install -g @ranger-testing/ranger-cli
 
 ## Quick Start
 
-1. Get your API token from [dashboard.ranger.net/settings](https://dashboard.ranger.net/settings)
+Go to [dashboard.ranger.net/cli](https://dashboard.ranger.net/cli) to get started.
 
-2. Initialize Ranger in your project:
-```bash
-ranger start <your-api-token>
-```
+## Claude Code Plugin
 
-3. Add an environment (e.g., local, staging, prod):
-```bash
-ranger add env local
-```
+For the best experience with Claude Code, install the Ranger plugin. Run these commands **inside Claude Code**:
 
-4. Install skills for Claude Code (run this in the directory where you want to use Ranger):
-```bash
-ranger skillup
 ```
-
-5. Start using Ranger skills in Claude Code! For example:
-```
-/bug-bash test the new feature on this branch
-/e2e-test-recommender recommend tests for this new feature
+/plugin marketplace add ranger-testing/trailhead
+/plugin install ranger@trailhead
 ```
 
+The plugin provides:
+- **Auto-firing hooks** - Automatically loads Ranger context at session start
+- **MCP tools** - Access to Ranger's test management and browser verification tools
+- **Feature tracking** - Track feature development with verifiable checklist items
+
+> **Note:** The plugin requires the CLI to be configured. Run `ranger start <token>` in a regular terminal first.
+
 ## Commands
 
 ### `ranger start <token>`
 
-Initialize Ranger in your project. Get your token from [dashboard.ranger.net/settings](https://dashboard.ranger.net/settings).
+Initialize Ranger in your project. Get your token from [dashboard.ranger.net/cli](https://dashboard.ranger.net/cli).
 
 This command:
 - Validates your API token
@@ -86,12 +81,12 @@ Switch to a different environment.
 ranger use staging
 ```
 
-### `ranger update env <env-name>`
+### `ranger env update <env-name>`
 
 Update authentication for an existing environment (re-capture cookies/storage).
 
 ```bash
-ranger update env staging
+ranger env update staging
 ```
 
 ### `ranger update`
@@ -177,16 +172,17 @@ Create a new feature with a checklist. Automatically captures git context (repo
 ```bash
 ranger feature create "User Authentication" \
   --description "Login, signup, and password reset flows" \
-  --checklist "Login works,Signup creates account,Password reset sends email"
+  -c "Login works" \
+  -c "Signup creates account" \
+  -c "Password reset sends email"
 ```
 
 #### `ranger feature list`
 
-List all features with status.
+List all features with session status.
 
 ```bash
 ranger feature list                    # All features
-ranger feature list --status in_progress
 ranger feature list --current-branch   # Features for current git branch
 ```
 
@@ -207,48 +203,15 @@ Set the active feature.
 ranger feature use feat_abc123
 ```
 
-#### `ranger feature resume`
-
-Find and use a feature matching the current git context (repo + branch).
-
-```bash
-ranger feature resume
-```
+#### `ranger feature resume [id]`
 
-#### `ranger feature block [id]`
+Find and use a feature matching the current git context (repo + branch). If multiple features match, prompts for selection.
 
-Mark a feature as blocked.
+Optionally pass a feature ID to resume directly (bypasses search/prompt - useful for automation).
 
 ```bash
-ranger feature block --reason "Waiting for API changes"
-```
-
-#### `ranger feature manage`
-
-Manage checklist items. Can be used interactively (for humans) or with flags (for agents/automation).
-
-**Interactive mode** (no flags):
-```bash
-ranger feature manage
-# Shows menu to add, edit, block, cancel, or reset items
-```
-
-**Non-interactive mode** (with flags - agent-friendly):
-```bash
-# Add a new checklist item
-ranger feature manage --add "New checklist item description"
-
-# Edit an item's description (1-based index)
-ranger feature manage --edit 1 --description "Updated description"
-
-# Block an item with reason
-ranger feature manage --block 2 --reason "Bug found in login flow"
-
-# Cancel an item with reason
-ranger feature manage --cancel 3 --reason "Descoped to v2"
-
-# Reset an item to pending
-ranger feature manage --reset 2
+ranger feature resume                  # Search by git context
+ranger feature resume feat_abc123      # Resume specific feature directly
 ```
 
 #### `ranger feature report [id]`
@@ -267,15 +230,15 @@ Verify a checklist item in the browser. Requires an active feature.
 
 ```bash
 ranger verify-feature \
-  --url "http://localhost:3000/login" \
   --task "Log in with valid credentials and verify redirect to dashboard"
 ```
 
+The URL is derived from your active environment's `baseUrl` setting.
+
 Options:
-- `--url` (required): URL to navigate to
+- `--env`: Environment to use (defaults to active environment)
 - `--task`: Task description (defaults to checklist item description)
 - `--item <index>`: Verify specific item by index (1-based)
-- `--new-item <description>`: Create and verify a new item
 
 ### `ranger clean`
 
@@ -429,4 +392,4 @@ Run `ranger add env <name>` to configure browser access for an environment.
 
 ### Authentication expired
 
-Run `ranger update env <env-name>` to refresh authentication cookies/storage.
+Run `ranger env update <env-name>` to refresh authentication cookies/storage.