# wst

Travel platform management for coding agents. Hotels, tours, bookings, h-conductor AI — as easy as git.

## Install

```bash
npm install -g weselltours
```

## Quick Start

```bash
# Create a tenant
wst signup my-agency --local

# File a bug
wst bug "Booking form returns 500" -s P1

# Plan a feature
wst feature "Calendar view for dates" -p P2

# See your project
wst status

# Ask tauAI
wst ask "how do hotel bookings work?"

# Full reference
wst --help
```

## Features

- **Services** — full CRUD for hotels, tours, cars, boats, events, spaces, flights
- **Bookings** — manage, confirm, cancel, export, invoices
- **Admin** — 135 subcommands: tenants, users, plans, vendors, payouts, media, content
- **h-conductor** — 13 travel domain AI experts
- **PM sync** — 209 features auto-scanned, coverage tracking
- **Operator** — dashboard, settings, subscription, theme, domains
- **Vendor** — services, rooms, availability, team, enquiries
- **Customer** — profile, bookings, wallet, messages, 2FA

## Per-Project Config

```bash
wst login --local --key YOUR_KEY    # saves to .wst/config.json (project-local)
wst login --key YOUR_KEY            # saves to ~/.wst/config.json (global)
wst config                          # show which config is active
```

Local config overrides global. Add `.wst/` to your `.gitignore`.

## Agent Integration

Add to your agent instructions file (AGENTS.md, .cursorrules, .clinerules, or .windsurfrules):

```
## WeSellTours
Use the wst CLI for travel platform management.
Key is in .wst/config.json (auto-loaded).
Run wst --help for full reference.
```

## MCP Server

wst ships a built-in [Model Context Protocol](https://modelcontextprotocol.io) server (stdio, zero extra dependencies) exposing 21 tools. Works with Claude Code, Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.

**Claude Code / Cursor / Windsurf** — add to `.mcp.json`:

```json
{
  "mcpServers": {
    "weselltours": {
      "type": "stdio",
      "command": "wst",
      "args": ["mcp-serve"]
    }
  }
}
```

**Claude Desktop** — add the same block to `claude_desktop_config.json`.

Authentication uses your existing wst config (`wst login --local --key YOUR_KEY`).

### Tools

| Tool | Description |
|------|-------------|
| `wst_status` | Project overview: PM inventory, coverage stats, domain breakdown. |
| `wst_dashboard` | Full dashboard: bookings, users, hotels, tours, recent activity. |
| `wst_ask` | Ask tauAI travel concierge (13 domain experts). |
| `wst_plan` | PM plan mode: bug-triage, feature-plan, e2e-design, roadmap. |
| `wst_experts` | List available h-conductor domain experts. |
| `wst_inventory` | PM feature inventory scan (209 features across 11 domains). |
| `wst_domains` | Per-domain coverage breakdown with feature counts. |
| `wst_board` | Feature kanban board grouped by status. |
| `wst_sync` | Sync PM features to Buggazi. |
| `wst_list_bugs` | List bugs, filter by severity or status. |
| `wst_create_bug` | File a new bug. |
| `wst_resolve_bug` | Resolve a bug with fix description and commit SHA. |
| `wst_comment` | Add comment to a bug. |
| `wst_list_features` | List features, filter by status or domain. |
| `wst_create_feature` | Plan a new feature. |
| `wst_hotels` | List all hotels. |
| `wst_create_hotel` | Create a new hotel listing. |
| `wst_bookings` | List bookings, filter by status. |
| `wst_tenants` | List all SaaS tenants (superadmin). |
| `wst_users` | List platform users (superadmin). |
| `wst_notifications` | What changed since last check. |

## Documentation

- [WeSellTours](https://weselltours.com)

## License

Proprietary — Tyga.Cloud Ltd. See [LICENSE](./LICENSE).