🎴 @trading-tazos-game/cli

Official CLI for the Trading Tazos Game — search, battle, and manage your digital tazo collection from the terminal.

Install

npm install -g @trading-tazos-game/cli

Requirements: Node.js ≥ 18

Quick Start

# Search a tazo
tazos search lumipuff

# Get full battle stats
tazos info cipherion

# See collection statistics
tazos stats

# Top 10 by attack power
tazos top --stat attack

# Simulate a battle (deterministic — same seed = same result!)
tazos battle --player 5 --opponent 5 --seed 42

Commands

| Command | Description | |---------|-------------| | tazos search [query] | Search tazos by name, slug, or number | | tazos info <name> | Show detailed 9-stat breakdown with bars | | tazos stats | Collection statistics by franchise, rarity, condition | | tazos top | Leaderboard by any stat (attack, defense, bounce...) | | tazos battle | Simulate a full battle with physics and captures |

Search Options

tazos search [query] [options]

  -f, --franchise <slug>   Filter: minimon, cybermon, dracobell
  -r, --rarity <rarity>    Filter: common, uncommon, rare, ultra, legendary
  -s, --stats              Show full 9-stat breakdown
  -l, --limit <n>          Max results (default: 15)

Battle Options

tazos battle [options]

  -p, --player <n>    Your team size (default: 5)
  -o, --opponent <n>  Opponent team size (default: 5)
  -s, --seed <n>      Random seed for reproducible battles
  -f, --fast          Skip detailed turn log

Authentication

Set your API token to access your personal collection:

export TAZOS_AUTH_TOKEN="your-jwt-token"

Get your token by logging in at tradingtazosgame.com and copying it from localStorage (ttg-token).

Features

• 🎯 9 Battle Stats — Attack, Defense, Resistance, Weight, Stability, Spin, Control, Bounce, Precision
• 🎲 Deterministic Battles — Seed-based RNG, same seed = same outcome every time
• 📊 Stat Bars — ASCII bar charts for visual stat comparison
• 🌈 Franchise Colors — Minimon yellow, Dracobell orange/red, Cybermon cyan
• ⭐ Rarity Stars — ★ common through ★★★★★ legendary
• 🔄 Reproducible — Every battle can be replayed with --seed

API

The CLI connects to the public Trading Tazos Game API:

• GET /api/tazos — Search, filter, sort tazos
• GET /api/stats — Collection statistics

The live public API currently exposes verified published tazos only. Draft Season 1 tazos stay hidden until their art and metadata pass QA.

Override the API base URL:

export TAZOS_API_URL="https://your-instance.com"

Programmatic Usage

import { api } from "@trading-tazos-game/cli"

const data = await api.search("lumipuff")
console.log(data.tazos[0].attack) // → 48

See src/index.ts for the full public API surface.

Development

git clone https://github.com/smouj/trading-tazos-game-cli.git
cd trading-tazos-game-cli
npm install
npm run build
node dist/cli.js --help

Related

• Trading Tazos Game — Play in your browser
• Main Repo — Full-stack Next.js game
• npm Package

License

MIT © Trading Tazos Game