runhuman 1.4.0 → 1.5.0

package/README.md

@@ -28,19 +28,39 @@ npx runhuman --help
 ## Quick Start
 
 ```bash
-# 1. Login with your API key
+# 1. Login (opens browser for OAuth)
 runhuman login
 
 # 2. Create your first test
-runhuman create https://myapp.com -d "Test the checkout flow"
+runhuman create https://google.com \
+  -d "Search for 'recursion' and confirm the tester experiences a joke about recursion"
 
 # 3. Check the status
-runhuman status <jobId>
+runhuman status job_abc123
 
 # 4. Get results
-runhuman results <jobId>
+runhuman results job_abc123
+```
+
+## Truncated IDs
+
+All commands accept truncated ID prefixes, similar to git short hashes. Instead of typing a full ID, you can use just the first few characters:
+
+```bash
+# Full ID
+runhuman status 712e42ad-8f3b-4a1c-9d5e-1234567890ab
+
+# Truncated — resolves to the same job
+runhuman status 712e
+
+# Hyphens are ignored during matching
+runhuman status 712e42ad8f3b
 ```
 
+If a prefix matches multiple resources, you'll be prompted to provide more characters. Matching is case-insensitive and hyphen-insensitive.
+
+**Destructive operations** (`projects delete`, `keys delete`, `projects transfer --to-org`) require the full ID to prevent accidental mismatches.
+
 ## Commands
 
 ### Jobs
@@ -51,26 +71,41 @@ Create a new QA test job.
 
 ```bash
 # Basic usage
-runhuman create https://myapp.com -d "Test checkout flow"
+runhuman create https://google.com \
+  -d "Search for 'recursion' and confirm the tester experiences a joke about recursion"
 
 # With template
-runhuman create https://myapp.com --template tmpl_abc123
+runhuman create https://google.com --template tmpl_abc123
 
 # Synchronous (wait for result)
-runhuman create https://myapp.com -d "Test" --sync
+runhuman create https://google.com -d "Test search" --sync
 
 # With custom schema
-runhuman create https://myapp.com -d "Test" --schema ./schema.json
+runhuman create https://google.com -d "Test search" --schema ./schema.json
+
+# With tester pool requirements
+runhuman create https://google.com -d "Test mobile layout" \
+  --required-devices ios,android \
+  --required-languages english
 ```
 
 **Options:**
 - `-d, --description <text>` - Test instructions for the human tester
-- `--template <id>` - Use a pre-defined template
-- `--duration <seconds>` - Target test duration
-- `--screen-size <size>` - Screen size (desktop/mobile/tablet)
-- `--schema <path>` - Path to JSON schema for structured output
-- `--sync` - Wait for result before exiting
-- `--json` - Output as JSON
+- `-t, --template <name>` - Use a pre-defined template
+- `--duration <minutes>` - Target duration (1-60 minutes)
+- `--device-class <class>` - Device class: desktop or mobile
+- `-S, --schema <file>` - Path to JSON schema for structured output
+- `--schema-inline <json>` - Inline JSON schema string
+- `--metadata <json>` - Metadata for tracking (JSON string)
+- `--github-repo <owner/repo>` - GitHub repo for context
+- `--required-devices <devices>` - Required tester devices (comma-separated: ios, android, pc, mac)
+- `--required-languages <languages>` - Required tester languages (comma-separated: english, spanish)
+- `--require-social-videos` - Require tester to create social videos
+- `-s, --sync` - Wait for result before exiting
+- `--wait <seconds>` - Max wait time in sync mode (default: 300)
+- `-p, --project <id>` - Project ID (or use default from config)
+- `-j, --json` - Output as JSON
+- `-q, --quiet` - Minimal output (only job ID)
 
 #### `status <jobId>`
 
@@ -78,11 +113,12 @@ Check the status of a test job.
 
 ```bash
 runhuman status job_abc123
+runhuman status 712e    # truncated ID works
 ```
 
 #### `wait <jobId>`
 
-Wait for a job to complete and display results.
+Wait for a job to complete with live status updates.
 
 ```bash
 runhuman wait job_abc123
@@ -91,6 +127,7 @@ runhuman wait job_abc123 --timeout 300
 
 **Options:**
 - `--timeout <seconds>` - Maximum wait time (default: 600)
+- `-j, --json` - Output as JSON
 
 #### `results <jobId>`
 
@@ -99,31 +136,100 @@ Display detailed test results.
 ```bash
 runhuman results job_abc123
 runhuman results job_abc123 --json
+runhuman results job_abc123 --schema-only   # Only extracted schema data
+runhuman results job_abc123 --raw           # Raw tester response
 ```
 
-#### `list`
+**Options:**
+- `--schema-only` - Show only extracted schema data
+- `--raw` - Show raw tester response without processing
+- `-j, --json` - Output as JSON
 
-List all your test jobs.
+#### `list [filter]`
+
+List all your test jobs with optional status filtering.
 
 ```bash
 # List all jobs
 runhuman list
 
-# Filter by status
-runhuman list --status completed
+# Filter by status (positional argument)
+runhuman list completed
+runhuman list pending
 
 # Filter by project
 runhuman list --project proj_abc123
 
-# Limit results
-runhuman list --limit 20
+# Pagination
+runhuman list --limit 20 --offset 40
 ```
 
+**Arguments:**
+- `[filter]` - Status filter: all, pending, claimed, in_progress, completed, failed, timeout
+
 **Options:**
-- `--status <status>` - Filter by status (pending/claimed/in_progress/completed/failed)
-- `--project <id>` - Filter by project
-- `--limit <number>` - Maximum number of jobs to return
-- `--json` - Output as JSON
+- `-p, --project <id>` - Filter by project
+- `-n, --limit <number>` - Maximum number of jobs (default: 20)
+- `--offset <number>` - Pagination offset (default: 0)
+- `--format <type>` - Output format: table, json, compact
+- `-j, --json` - Output as JSON
+
+#### `delete <jobId>`
+
+Delete a job permanently.
+
+```bash
+runhuman delete job_abc123 --force
+```
+
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `-j, --json` - Output as JSON
+
+### Organizations
+
+#### `orgs list`
+
+List all organizations you belong to.
+
+```bash
+runhuman orgs list
+runhuman orgs ls    # alias
+```
+
+#### `orgs show <organizationId>`
+
+Show organization details.
+
+```bash
+runhuman orgs show org_abc123
+runhuman orgs info org_abc123   # alias
+```
+
+#### `orgs balance <organizationId>`
+
+Check billing balance.
+
+```bash
+runhuman orgs balance org_abc123
+```
+
+#### `orgs projects <organizationId>`
+
+List all projects in an organization.
+
+```bash
+runhuman orgs projects org_abc123
+```
+
+#### `orgs switch <organizationId>`
+
+Set the default organization for CLI commands.
+
+```bash
+runhuman orgs switch org_abc123
+runhuman orgs switch org_abc123 --global   # all directories (default)
+```
 
 ### Projects
 
@@ -133,139 +239,212 @@ List all your projects.
 
 ```bash
 runhuman projects list
-runhuman projects ls  # alias
+runhuman projects ls    # alias
 ```
 
 #### `projects create <name>`
 
-Create a new project.
+Create a new project in an organization.
 
 ```bash
-runhuman projects create "My App"
-runhuman projects create "My App" -d "Production QA testing"
+runhuman projects create "My App" --organization org_abc123
+runhuman projects create "My App" --organization org_abc123 --set-default
 ```
 
 **Options:**
-- `-d, --description <text>` - Project description
-- `--default-url <url>` - Default URL to test
+- `-o, --organization <id>` - Organization ID (required)
+- `--default-url <url>` - Default URL for tests
 - `--github-repo <owner/repo>` - Link GitHub repository
+- `--set-default` - Set as default project after creation
 
 #### `projects show <projectId>`
 
-Show details of a specific project.
+Show project details including organization and balance.
 
 ```bash
 runhuman projects show proj_abc123
-runhuman projects info proj_abc123  # alias
+runhuman projects info proj_abc123    # alias
+runhuman projects get proj_abc123     # alias
 ```
 
 #### `projects update <projectId>`
 
-Update a project.
+Update project settings.
 
 ```bash
 runhuman projects update proj_abc123 --name "New Name"
-runhuman projects update proj_abc123 --description "New description"
+runhuman projects update proj_abc123 --default-url https://google.com
 ```
 
 **Options:**
-- `--name <name>` - New project name
-- `-d, --description <text>` - New description
-- `--default-url <url>` - New default URL
-- `--github-repo <owner/repo>` - New GitHub repository
+- `-n, --name <text>` - New project name
+- `-u, --default-url <url>` - New default URL
+- `-g, --github-repo <owner/repo>` - New GitHub repository
+
+#### `projects switch <projectId>`
+
+Set the default project for CLI commands.
+
+```bash
+runhuman projects switch proj_abc123
+runhuman projects use proj_abc123     # alias
+```
+
+**Options:**
+- `-g, --global` - Set as global default instead of local (default: true)
+
+#### `projects transfer <projectId>`
+
+Transfer a project to another organization.
+
+```bash
+runhuman projects transfer proj_abc123 --to-org org_target123
+```
+
+**Options:**
+- `--to-org <organizationId>` - Target organization ID (required, full ID required)
+- `-f, --force` - Skip confirmation prompt
 
 #### `projects delete <projectId>`
 
-Delete a project permanently.
+Delete a project permanently. Requires the full project ID.
 
 ```bash
 runhuman projects delete proj_abc123 --force
 ```
 
 **Options:**
-- `--force` - Skip confirmation prompt
+- `-f, --force` - Skip confirmation prompt
+
+### Transfers
+
+#### `transfers list`
+
+List pending and outgoing project transfers.
+
+```bash
+runhuman transfers list
+runhuman transfers ls    # alias
+```
+
+#### `transfers accept <transferId>`
+
+Accept an incoming transfer.
+
+```bash
+runhuman transfers accept xfer_abc123
+```
+
+#### `transfers reject <transferId>`
+
+Reject an incoming transfer.
+
+```bash
+runhuman transfers reject xfer_abc123
+```
+
+#### `transfers cancel <transferId>`
+
+Cancel an outgoing transfer you initiated.
+
+```bash
+runhuman transfers cancel xfer_abc123
+```
 
 ### API Keys
 
 #### `keys list`
 
-List all API keys for a project.
+List all API keys for an organization.
 
 ```bash
-runhuman keys list --project proj_abc123
-runhuman keys ls --project proj_abc123  # alias
+runhuman keys list --organization org_abc123
+runhuman keys ls --organization org_abc123    # alias
+runhuman keys list --organization org_abc123 --show-keys
 ```
 
 **Options:**
-- `--project <id>` - Project ID (required)
+- `-o, --organization <id>` - Organization ID (required)
 - `--show-keys` - Show full API keys (default: masked)
+- `-j, --json` - Output as JSON
 
 #### `keys create <name>`
 
-Create a new API key.
+Create a new API key for an organization.
 
 ```bash
-runhuman keys create "CI/CD Key" --project proj_abc123
-runhuman keys new "CI/CD Key" --project proj_abc123  # alias
+runhuman keys create "CI/CD Key" --organization org_abc123
+runhuman keys new "CI/CD Key" --organization org_abc123    # alias
 ```
 
 **Options:**
-- `--project <id>` - Project ID (required)
+- `-o, --organization <id>` - Organization ID (required)
 - `--copy` - Copy key to clipboard
 
+#### `keys show <keyId>`
+
+Show details of a specific API key.
+
+```bash
+runhuman keys show key_abc123
+runhuman keys show key_abc123 --show-key
+```
+
+**Options:**
+- `--show-key` - Show full API key (default: masked)
+
 #### `keys delete <keyId>`
 
-Delete an API key permanently.
+Delete an API key permanently. Requires the full key ID.
 
 ```bash
 runhuman keys delete key_abc123 --force
-runhuman keys rm key_abc123 --force  # alias
+runhuman keys rm key_abc123 --force       # alias
+runhuman keys revoke key_abc123 --force   # alias
 ```
 
 **Options:**
-- `--force` - Skip confirmation prompt
+- `-f, --force` - Skip confirmation prompt
 
 ### Templates
 
 #### `templates list`
 
-List all test templates for a project.
+List all templates for a project.
 
 ```bash
 runhuman templates list --project proj_abc123
-runhuman templates ls --project proj_abc123  # alias
+runhuman templates ls --project proj_abc123    # alias
 ```
 
 **Options:**
-- `--project <id>` - Project ID (required)
+- `-p, --project <id>` - Project ID (required, or use default from config)
 
 #### `templates create <name>`
 
-Create a new test template.
+Create a new template.
 
 ```bash
-runhuman templates create "Checkout Flow" --project proj_abc123
-runhuman templates create "Login Test" --project proj_abc123 \
-  -d "Test login functionality" \
+runhuman templates create "Search Flow Test" --project proj_abc123 \
+  -d "Search for 'recursion' and confirm the joke appears" \
   --duration 180 \
-  --screen-size mobile \
+  --device-class desktop \
   --schema ./schema.json
 ```
 
 **Options:**
-- `--project <id>` - Project ID (required)
+- `-p, --project <id>` - Project ID (required, or use default from config)
 - `-d, --description <text>` - Template description
-- `--duration <seconds>` - Target test duration
-- `--screen-size <size>` - Default screen size
-- `--schema <path>` - Path to JSON schema file
+- `--duration <seconds>` - Target test duration in seconds
+- `--device-class <class>` - Default device class (desktop/mobile)
+- `-S, --schema <path>` - Path to JSON schema file
 
 #### `templates show <templateId>`
 
-Show details of a specific template.
+Show template details.
 
 ```bash
-runhuman templates show tmpl_abc123
-runhuman templates info tmpl_abc123  # alias
+runhuman templates show tmpl_abc123 --project proj_abc123
 ```
 
 #### `templates update <templateId>`
@@ -273,29 +452,26 @@ runhuman templates info tmpl_abc123  # alias
 Update a template.
 
 ```bash
-runhuman templates update tmpl_abc123 --name "New Name"
-runhuman templates update tmpl_abc123 --description "New description"
-runhuman templates update tmpl_abc123 --schema ./new-schema.json
+runhuman templates update tmpl_abc123 --project proj_abc123 --name "New Name"
 ```
 
 **Options:**
-- `--name <name>` - New template name
+- `-n, --name <name>` - New template name
 - `-d, --description <text>` - New description
 - `--duration <seconds>` - New target duration
-- `--screen-size <size>` - New default screen size
-- `--schema <path>` - Path to new JSON schema file
+- `--device-class <class>` - New default device class
+- `-S, --schema <path>` - Path to new JSON schema file
 
 #### `templates delete <templateId>`
 
-Delete a template permanently.
+Delete a template.
 
 ```bash
-runhuman templates delete tmpl_abc123 --force
-runhuman templates rm tmpl_abc123 --force  # alias
+runhuman templates delete tmpl_abc123 --project proj_abc123 --force
 ```
 
 **Options:**
-- `--force` - Skip confirmation prompt
+- `-f, --force` - Skip confirmation prompt
 
 ### GitHub Integration
 
@@ -305,23 +481,23 @@ Link a GitHub repository to your project.
 
 ```bash
 runhuman github link owner/repo --project proj_abc123
-runhuman gh link volter-ai/runhuman --project proj_abc123  # alias
 ```
 
 **Options:**
-- `--project <id>` - Project ID (required)
+- `-p, --project <id>` - Project ID (required)
 
 #### `github repos`
 
-List linked GitHub repositories.
+List GitHub repositories accessible to an organization.
 
 ```bash
-runhuman github repos
-runhuman github repos --project proj_abc123  # filter by project
+runhuman github repos --organization org_abc123
+runhuman github repos --organization org_abc123 --search "my-app"
 ```
 
 **Options:**
-- `--project <id>` - Filter by project
+- `-o, --organization <id>` - Organization ID (required)
+- `-s, --search <query>` - Filter by repository name
 
 #### `github issues <repo>`
 
@@ -334,65 +510,62 @@ runhuman github issues owner/repo --labels "bug,needs-qa"
 ```
 
 **Options:**
-- `--state <state>` - Filter by state (open/closed/all, default: open)
-- `--labels <labels>` - Filter by comma-separated labels
+- `-s, --state <state>` - Filter by state (open/closed/all, default: open)
+- `-l, --labels <labels>` - Filter by comma-separated labels
 
 #### `github test <issueNumber>`
 
 Create a QA test job for a GitHub issue.
 
 ```bash
-runhuman github test 123 --repo owner/repo --url https://myapp.com
-runhuman github test 123 --url https://myapp.com --sync  # wait for result
+runhuman github test 123 -r owner/repo -u https://google.com
+runhuman github test 123 -u https://google.com --sync
 ```
 
 **Options:**
-- `--repo <owner/repo>` - Repository (or use default from config)
-- `--url <url>` - URL to test (required)
-- `--template <id>` - Template ID to use
-- `--sync` - Wait for result before exiting
+- `-r, --repo <owner/repo>` - Repository (or use default from config)
+- `-u, --url <url>` - URL to test (required)
+- `-t, --template <id>` - Template ID to use
+- `-s, --sync` - Wait for result before exiting
 
 #### `github bulk-test`
 
 Create QA test jobs for multiple GitHub issues.
 
 ```bash
-# Test all open issues
-runhuman github bulk-test --repo owner/repo --url https://myapp.com
-
-# Test issues with specific labels
-runhuman github bulk-test --repo owner/repo --url https://myapp.com \
-  --labels "bug,needs-qa" \
-  --limit 5
+runhuman github bulk-test -r owner/repo -u https://google.com
+runhuman github bulk-test -r owner/repo -u https://google.com \
+  -l "bug,needs-qa" \
+  -n 5
 ```
 
 **Options:**
-- `--repo <owner/repo>` - Repository (or use default from config)
-- `--url <url>` - URL to test (required)
-- `--labels <labels>` - Filter issues by comma-separated labels
-- `--state <state>` - Filter by state (open/closed/all, default: open)
-- `--template <id>` - Template ID to use
-- `--limit <number>` - Maximum number of jobs to create (default: 10)
+- `-r, --repo <owner/repo>` - Repository (or use default from config)
+- `-u, --url <url>` - URL to test (required)
+- `-l, --labels <labels>` - Filter issues by comma-separated labels
+- `-s, --state <state>` - Filter by state (open/closed/all, default: open)
+- `-t, --template <id>` - Template ID to use
+- `-n, --limit <number>` - Maximum number of jobs to create (default: 10)
 
 ### Authentication
 
 #### `login`
 
-Login to Runhuman and save your API key.
+Login to Runhuman. Opens your browser for OAuth by default.
 
 ```bash
 runhuman login
-# Prompts for API key
 
-# Or provide directly
-runhuman login --api-key qa_live_xxxxxxxxxxxxx
-```
+# Login with API key (skip browser)
+runhuman login --token <your-api-key>
 
-Get your API key at: [runhuman.com/dashboard](https://runhuman.com/dashboard)
+# Print auth URL without opening browser
+runhuman login --no-browser
+```
 
 #### `logout`
 
-Logout and clear saved credentials.
+Clear saved credentials.
 
 ```bash
 runhuman logout
@@ -400,7 +573,7 @@ runhuman logout
 
 #### `whoami`
 
-Display current user info and account balance.
+Display current user info.
 
 ```bash
 runhuman whoami
@@ -422,12 +595,9 @@ runhuman config get project
 Set a configuration value.
 
 ```bash
-# Set globally
-runhuman config set apiUrl https://api.runhuman.com --global
-
-# Set for current project
 runhuman config set project proj_abc123
-runhuman config set defaultUrl https://myapp.com
+runhuman config set color false
+runhuman config set project proj_abc123 --global
 ```
 
 **Options:**
@@ -439,27 +609,20 @@ List all configuration values.
 
 ```bash
 runhuman config list
+runhuman config list --show-secrets
 ```
 
-Shows configuration from all sources:
-- Global config (`~/.config/runhuman/config.json`)
-- Project config (`.runhumanrc`)
-- Environment variables
-- Effective (merged) config
+**Options:**
+- `--show-secrets` - Show API keys (default: masked)
 
 #### `config reset`
 
 Reset configuration to defaults.
 
 ```bash
-# Reset project config
-runhuman config reset project
-
-# Reset global config
-runhuman config reset global
-
-# Reset all
-runhuman config reset all
+runhuman config reset --project --force
+runhuman config reset --global --force
+runhuman config reset --all --force
 ```
 
 #### `init`
@@ -468,17 +631,16 @@ Initialize a new Runhuman project with interactive prompts.
 
 ```bash
 runhuman init
+runhuman init --name "My App" --url https://google.com --yes
 ```
 
-Creates a `.runhumanrc` file in the current directory with your project configuration.
+Creates a `.runhumanrc` file in the current directory.
 
-## Configuration
-
-### Configuration Hierarchy
+## Configuration Hierarchy
 
 Configuration is loaded from multiple sources with the following priority (highest to lowest):
 
-1. **CLI flags** - `--api-key`, `--api-url`, etc.
+1. **CLI flags** - `--api-key`, `--project`, etc.
 2. **Environment variables** - `RUNHUMAN_API_KEY`, `RUNHUMAN_API_URL`, etc.
 3. **Project config** - `.runhumanrc` in current directory
 4. **Global config** - `~/.config/runhuman/config.json`
@@ -487,70 +649,28 @@ Configuration is loaded from multiple sources with the following priority (highe
 ### Environment Variables
 
 ```bash
-RUNHUMAN_API_KEY         # API key for authentication
-RUNHUMAN_API_URL         # API base URL (default: https://runhuman.com)
-RUNHUMAN_PROJECT         # Default project ID
-RUNHUMAN_DEFAULT_URL     # Default URL to test
-RUNHUMAN_DEFAULT_DURATION  # Default test duration in seconds
-RUNHUMAN_DEFAULT_SCREEN_SIZE  # Default screen size (desktop/mobile/tablet)
-RUNHUMAN_OUTPUT_FORMAT   # Output format (pretty/json/compact)
-RUNHUMAN_NO_COLOR=1      # Disable colored output
-```
-
-### Project Config (`.runhumanrc`)
-
-Create a `.runhumanrc` file in your project root:
-
-```json
-{
-  "project": "proj_abc123",
-  "defaultUrl": "https://myapp.com",
-  "defaultDuration": 300,
-  "defaultScreenSize": "desktop",
-  "githubRepo": "owner/repo",
-  "outputFormat": "pretty",
-  "color": true
-}
-```
-
-### Global Config
-
-Stored at `~/.config/runhuman/config.json`:
-
-```json
-{
-  "apiUrl": "https://runhuman.com",
-  "apiKey": "qa_live_xxxxxxxxxxxxx",
-  "color": true
-}
+RUNHUMAN_API_KEY           # API key for authentication
+RUNHUMAN_API_URL           # API base URL (default: https://runhuman.com)
+RUNHUMAN_PROJECT_ID        # Default project ID
+RUNHUMAN_NO_COLOR=true     # Disable colored output
 ```
 
 ## JSON Output
 
-All commands support `--json` flag for machine-readable output:
+All commands support `-j, --json` for machine-readable output:
 
 ```bash
-runhuman create https://myapp.com -d "Test" --json
+runhuman create https://google.com -d "Test search" --json
 runhuman status job_abc123 --json
 runhuman list --json
 ```
 
-JSON output format:
-
-```json
-{
-  "success": true,
-  "data": { ... },
-  "error": null
-}
-```
-
 ## Exit Codes
 
 - `0` - Success
-- `1` - General error
+- `1` - General error / ambiguous ID / full ID required
 - `2` - Authentication error
-- `3` - Not found error
+- `3` - Not found / no match for ID prefix
 - `4` - Validation error
 - `5` - Timeout error
 
@@ -566,68 +686,34 @@ runhuman login
 runhuman init
 
 # 3. Create a test
-runhuman create https://myapp.com -d "Test the login flow"
+runhuman create https://google.com \
+  -d "Search for 'recursion' and confirm the tester experiences a joke about recursion"
 
-# 4. Wait for results
-runhuman wait job_abc123
+# 4. Wait for results (truncated ID)
+runhuman wait 712e
 
 # 5. View detailed results
-runhuman results job_abc123
+runhuman results 712e
 ```
 
 ### CI/CD Integration
 
 ```bash
-# Create test and wait for result (fail on error)
-runhuman create https://staging.myapp.com \
-  -d "Smoke test on staging" \
+runhuman create https://staging.google.com \
+  -d "Search for 'recursion' and confirm the joke appears" \
   --sync \
   --json > result.json
-
-# Exit code will be non-zero if test fails
-```
-
-### GitHub Integration Workflow
-
-```bash
-# 1. Link your repo
-runhuman github link owner/repo --project proj_abc123
-
-# 2. List issues needing QA
-runhuman github issues owner/repo --labels "needs-qa"
-
-# 3. Test a specific issue
-runhuman github test 42 --url https://myapp.com --sync
-
-# 4. Bulk test multiple issues
-runhuman github bulk-test --url https://myapp.com --labels "needs-qa" --limit 5
-```
-
-### Using Templates
-
-```bash
-# 1. Create a template
-runhuman templates create "Login Flow Test" --project proj_abc123 \
-  -d "Test login with valid and invalid credentials" \
-  --duration 180 \
-  --schema ./schemas/login-test.json
-
-# 2. Use the template
-runhuman create https://myapp.com --template tmpl_abc123
-
-# 3. List all templates
-runhuman templates list --project proj_abc123
 ```
 
-## MCP Server for AI Agents
-
-If you're using AI agents (Claude, GPT, etc.), check out our MCP server package:
+## How It Works
 
-```bash
-npm install -g @runhuman/mcp
-```
+1. **You create a job** - Define test instructions and optional output schema
+2. **Job posted to testers** - Request goes to human tester pool
+3. **Human performs test** - Real person tests with video/screenshot recording
+4. **AI extracts data** - AI processes feedback into structured JSON
+5. **You get results** - Clean, typed data ready for automation
 
-See [@runhuman/mcp](https://www.npmjs.com/package/@runhuman/mcp) for details.
+**Pricing:** Pay-per-second ($0.0085/sec of tester time). No monthly fees, no minimums.
 
 ## Learn More
 
@@ -640,16 +726,6 @@ See [@runhuman/mcp](https://www.npmjs.com/package/@runhuman/mcp) for details.
 - **Email:** hey@runhuman.com
 - **Issues:** [GitHub Issues](https://github.com/volter-ai/runhuman/issues)
 
-## How It Works
-
-1. **You create a job** - Define test instructions and optional output schema
-2. **Job posted to testers** - Request goes to human tester pool
-3. **Human performs test** - Real person tests with video/screenshot recording
-4. **AI extracts data** - GPT-4o processes feedback into structured JSON
-5. **You get results** - Clean, typed data ready for automation
-
-**Pricing:** Pay-per-second ($0.0085/sec of tester time). No monthly fees, no minimums.
-
 ---
 
-**Built with ❤️ by the [Volter AI](https://volter.ai) team**
+**Built by the [Volter AI](https://volter.ai) team**