{"id":50796872,"url":"https://github.com/smouj/trading-tazos-game-cli","last_synced_at":"2026-06-12T15:01:57.955Z","repository":{"id":362154749,"uuid":"1257635934","full_name":"smouj/trading-tazos-game-cli","owner":"smouj","description":"🎮 Official CLI for the Trading Tazos Game — search, battle, and manage your digital tazo collection from the terminal","archived":false,"fork":false,"pushed_at":"2026-06-11T14:48:47.000Z","size":6482,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T16:23:31.896Z","etag":null,"topics":["battle-game","cli","cybermon","dracobell","minimon","nostalgia","npm-package","pogs","retro-gaming","tazos","terminal","typescript"],"latest_commit_sha":null,"homepage":"https://tradingtazosgame.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smouj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-02T21:40:26.000Z","updated_at":"2026-06-11T15:07:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/smouj/trading-tazos-game-cli","commit_stats":null,"previous_names":["smouj/trading-tazos-game-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/smouj/trading-tazos-game-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smouj%2Ftrading-tazos-game-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smouj%2Ftrading-tazos-game-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smouj%2Ftrading-tazos-game-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smouj%2Ftrading-tazos-game-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smouj","download_url":"https://codeload.github.com/smouj/trading-tazos-game-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smouj%2Ftrading-tazos-game-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34249561,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["battle-game","cli","cybermon","dracobell","minimon","nostalgia","npm-package","pogs","retro-gaming","tazos","terminal","typescript"],"created_at":"2026-06-12T15:01:51.529Z","updated_at":"2026-06-12T15:01:57.938Z","avatar_url":"https://github.com/smouj.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎴 @trading-tazos-game/cli\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./logo-complete-black.png\" alt=\"Trading Tazos Game CLI\" height=\"80\" /\u003e\n\n\u003e Official CLI for the **Trading Tazos Game** — search, battle, and manage your digital tazo collection from the terminal.\n\n[![npm version](https://img.shields.io/npm/v/@trading-tazos-game/cli)](https://www.npmjs.com/package/@trading-tazos-game/cli)\n[![license](https://img.shields.io/npm/l/@trading-tazos-game/cli)](./LICENSE)\n[![node](https://img.shields.io/node/v/@trading-tazos-game/cli)](https://nodejs.org)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/smouj/trading-tazos-game-cli/pulls)\n\n---\n\n## Install\n\n```bash\nnpm install -g @trading-tazos-game/cli\n```\n\nRequirements: **Node.js ≥ 18**\n\n## Quick Start\n\n```bash\n# Search a tazo\ntazos search lumipuff\n\n# Get full battle stats\ntazos info cipherion\n\n# See collection statistics\ntazos stats\n\n# Top 10 by attack power\ntazos top --stat attack\n\n# Simulate a battle (deterministic — same seed = same result!)\ntazos battle --player 5 --opponent 5 --seed 42\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `tazos search [query]` | Search tazos by name, slug, or number |\n| `tazos info \u003cname\u003e` | Show detailed 9-stat breakdown with bars |\n| `tazos stats` | Collection statistics by franchise, rarity, condition |\n| `tazos top` | Leaderboard by any stat (attack, defense, bounce...) |\n| `tazos battle` | Simulate a full battle with physics and captures |\n\n### Search Options\n\n```\ntazos search [query] [options]\n\n  -f, --franchise \u003cslug\u003e   Filter: minimon, cybermon, dracobell\n  -r, --rarity \u003crarity\u003e    Filter: common, uncommon, rare, ultra, legendary\n  -s, --stats              Show full 9-stat breakdown\n  -l, --limit \u003cn\u003e          Max results (default: 15)\n```\n\n### Battle Options\n\n```\ntazos battle [options]\n\n  -p, --player \u003cn\u003e    Your team size (default: 5)\n  -o, --opponent \u003cn\u003e  Opponent team size (default: 5)\n  -s, --seed \u003cn\u003e      Random seed for reproducible battles\n  -f, --fast          Skip detailed turn log\n```\n\n## Authentication\n\nSet your API token to access your personal collection:\n\n```bash\nexport TAZOS_AUTH_TOKEN=\"your-jwt-token\"\n```\n\nGet your token by logging in at [tradingtazosgame.com](https://tradingtazosgame.com) and copying it from localStorage (`ttg-token`).\n\n## Features\n\n- 🎯 **9 Battle Stats** — Attack, Defense, Resistance, Weight, Stability, Spin, Control, Bounce, Precision\n- 🎲 **Deterministic Battles** — Seed-based RNG, same seed = same outcome every time\n- 📊 **Stat Bars** — ASCII bar charts for visual stat comparison\n- 🌈 **Franchise Colors** — Minimon yellow, Dracobell orange/red, Cybermon cyan\n- ⭐ **Rarity Stars** — ★ common through ★★★★★ legendary\n- 🔄 **Reproducible** — Every battle can be replayed with `--seed`\n\n## API\n\nThe CLI connects to the public [Trading Tazos Game API](https://tradingtazosgame.com):\n\n- `GET /api/tazos` — Search, filter, sort tazos\n- `GET /api/stats` — Collection statistics\n\nThe live public API currently exposes verified published tazos only. Draft Season 1 tazos stay hidden until their art and metadata pass QA.\n\nOverride the API base URL:\n\n```bash\nexport TAZOS_API_URL=\"https://your-instance.com\"\n```\n\n## Programmatic Usage\n\n```typescript\nimport { api } from \"@trading-tazos-game/cli\"\n\nconst data = await api.search(\"lumipuff\")\nconsole.log(data.tazos[0].attack) // → 48\n```\n\nSee `src/index.ts` for the full public API surface.\n\n## Development\n\n```bash\ngit clone https://github.com/smouj/trading-tazos-game-cli.git\ncd trading-tazos-game-cli\nnpm install\nnpm run build\nnode dist/cli.js --help\n```\n\n## Related\n\n- [Trading Tazos Game](https://tradingtazosgame.com) — Play in your browser\n- [Main Repo](https://github.com/smouj/Trading-Tazos-Game) — Full-stack Next.js game\n- [npm Package](https://www.npmjs.com/package/@trading-tazos-game/cli)\n\n## License\n\nMIT © Trading Tazos Game\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmouj%2Ftrading-tazos-game-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmouj%2Ftrading-tazos-game-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmouj%2Ftrading-tazos-game-cli/lists"}