https://github.com/smouj/trading-tazos-game-cli
🎮 Official CLI for the Trading Tazos Game — search, battle, and manage your digital tazo collection from the terminal
https://github.com/smouj/trading-tazos-game-cli
battle-game cli cybermon dracobell minimon nostalgia npm-package pogs retro-gaming tazos terminal typescript
Last synced: 5 days ago
JSON representation
🎮 Official CLI for the Trading Tazos Game — search, battle, and manage your digital tazo collection from the terminal
- Host: GitHub
- URL: https://github.com/smouj/trading-tazos-game-cli
- Owner: smouj
- License: mit
- Created: 2026-06-02T21:40:26.000Z (15 days ago)
- Default Branch: main
- Last Pushed: 2026-06-11T14:48:47.000Z (6 days ago)
- Last Synced: 2026-06-11T16:23:31.896Z (6 days ago)
- Topics: battle-game, cli, cybermon, dracobell, minimon, nostalgia, npm-package, pogs, retro-gaming, tazos, terminal, typescript
- Language: TypeScript
- Homepage: https://tradingtazosgame.com
- Size: 6.18 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎴 @trading-tazos-game/cli
> Official CLI for the **Trading Tazos Game** — search, battle, and manage your digital tazo collection from the terminal.
[](https://www.npmjs.com/package/@trading-tazos-game/cli)
[](./LICENSE)
[](https://nodejs.org)
[](https://github.com/smouj/trading-tazos-game-cli/pulls)
---
## Install
```bash
npm install -g @trading-tazos-game/cli
```
Requirements: **Node.js ≥ 18**
## Quick Start
```bash
# 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 ` | 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 Filter: minimon, cybermon, dracobell
-r, --rarity Filter: common, uncommon, rare, ultra, legendary
-s, --stats Show full 9-stat breakdown
-l, --limit Max results (default: 15)
```
### Battle Options
```
tazos battle [options]
-p, --player Your team size (default: 5)
-o, --opponent Opponent team size (default: 5)
-s, --seed Random seed for reproducible battles
-f, --fast Skip detailed turn log
```
## Authentication
Set your API token to access your personal collection:
```bash
export TAZOS_AUTH_TOKEN="your-jwt-token"
```
Get your token by logging in at [tradingtazosgame.com](https://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](https://tradingtazosgame.com):
- `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:
```bash
export TAZOS_API_URL="https://your-instance.com"
```
## Programmatic Usage
```typescript
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
```bash
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](https://tradingtazosgame.com) — Play in your browser
- [Main Repo](https://github.com/smouj/Trading-Tazos-Game) — Full-stack Next.js game
- [npm Package](https://www.npmjs.com/package/@trading-tazos-game/cli)
## License
MIT © Trading Tazos Game