@xtest-cli/cli

The official CLI for xtest.ing - AI-Powered Browser Automation & Test Generation Platform.


Installation

``bash
npm install -g @xtest-cli/cli@latest
`

Features

- Remote Browser Control: Control browser sessions running on xtest.ing infrastructure
- Live Browser View: See what's happening in real-time with headed mode
- AI-Powered Testing: Generate intelligent test cases using AI
- Session Management: Create, list, and manage multiple browser sessions
- Secure Authentication: Email/password authentication with JWT tokens
- Subscription-Based: Requires active xtest.ing subscription
- Interactive Mode: NEW! Control dual browsers with persistent state
- Mirror Mode: NEW! Synchronized browser control - actions mirror between browsers

Prerequisites

- Node.js 16.0.0 or higher
- Active xtest.ing subscription
- xtest.ing account credentials

Installation

`bash
npm install -g @xtest-cli/cli@latest
`

Authentication

The CLI uses email/password authentication. You'll need:
1. An active xtest.ing account
2. A valid subscription
3. Your account credentials

$3

`bash
xtest auth
`

You'll be prompted for:
- Email: Your xtest.ing account email
- Password: Your account password
- Server URL: Default is https://xtest.ing

Example:
`
Login to xtest.ing

Note: You need an active subscription to use the CLI
Sign up at: https://xtest.ing/pricing

Email: user@example.com
Password: ••••••••

✓ Login successful!
Welcome back, John!
Subscription: Active
`

$3

`bash
xtest auth status
`

$3

`bash
xtest auth logout
`

Quick Start

1. Install the CLI
`bash
npm install -g @xtest-cli/cli@latest
`

2. Login to your account
`bash
xtest auth
`

3. Start a browser session
`bash
xtest browser --mode headed
`

4. Navigate to a website
`bash
xtest browser --url https://example.com
`

Commands

$3

| Command | Description |
|---------|-------------|
| xtest auth | Login with your xtest.ing credentials |
| xtest auth status | Check authentication and subscription status |
| xtest auth logout | Logout and clear stored credentials |

$3

| Command | Description |
|---------|-------------|
| xtest browser | Start a browser session (headless by default) |
| xtest browser --mode headed | Start browser in headed mode (visible) |
| xtest browser --mode headless | Start browser in headless mode |
| xtest browser --url | Navigate to specific URL on start |
| xtest browser --type | Browser type: chromium, firefox, webkit |

$3

| Command | Description |
|---------|-------------|
| xtest sessions list | List all active browser sessions |
| xtest sessions | Alias for sessions list |

$3

| Command | Description |
|---------|-------------|
| xtest interactive | Start interactive dual browser control |
| xtest i | Alias for interactive mode |

#### Interactive Mode Commands

Once in interactive mode, you can use these commands:

- local - Navigate local browser to URL
- cloud - Navigate cloud browser to URL
- local click - Click element in local browser
- cloud click - Click element in cloud browser
- local type - Type text in local browser
- cloud type - Type text in cloud browser
- status - Show current state of both browsers
- exit - Close both browsers and exit

$3

| Command | Description |
|---------|-------------|
| xtest mirror | Start synchronized browser control |
| xtest mirror --url | Start with specific URL |

Mirror mode launches two browsers:
- Local Browser: Opens on your laptop (visible)
- Cloud Browser: Runs on xtest.ing servers

All actions in the local browser are automatically mirrored to the cloud browser in real-time!

$3

`bash


Start mirror mode with default URL (Google)

xtest mirror

Start with a specific URL

xtest mirror --url https://github.com

What happens:

1. Local browser opens on your laptop

2. Cloud browser starts on xtest.ing

3. Navigate, click, or type in local browser

4. Actions automatically mirror to cloud browser

5. Both browsers stay in sync!

`

Usage Examples

$3

`bash

Start a visible browser session

xtest browser --mode headed

Navigate to a specific URL

xtest browser --url https://github.com --mode headed

Use Firefox instead of Chromium

xtest browser --type firefox --mode headed
`

$3

`bash

Start interactive mode

xtest interactive

In the interactive prompt:

xtest> local https://google.com
xtest> cloud https://github.com
xtest> status
xtest> exit
`

$3

`bash

List all your active sessions

xtest sessions list

Check your authentication status

xtest auth status
`

Security

- Token-Based: Uses JWT tokens that expire after 30 days
- Secure Storage: Credentials are stored securely in your home directory
- Subscription Required: All commands require an active subscription
- HTTPS Only: All communication is encrypted

Subscription Management

The CLI requires an active xtest.ing subscription. To manage your subscription:

1. Visit xtest.ing
2. Login to your account
3. Click on your profile → "Manage Subscription"
4. You'll be redirected to the Stripe customer portal

Configuration

Configuration is stored in ~/.xtest/config.json:

`json
{
"apiKey": "your-jwt-token",
"serverUrl": "https://xtest.ing"
}
`

Troubleshooting

$3


- Ensure you have an active subscription at https://xtest.ing/pricing
- Try logging out and logging in again: xtest auth logout then xtest auth`

$3

- Double-check your email and password
- Ensure your account is active
- Try resetting your password on the website

$3

- Check your internet connection
- Verify the server URL (default: https://xtest.ing)
- Check if you're behind a firewall or proxy

Changelog

See CHANGELOG.md for version history.

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT - see LICENSE for details.

Support

- Email: support@xtest.ing
- Website: xtest.ing
- Issues: GitHub Issues

---

Made with love by the xtest.ing team