typecov

Pokemon type coverage analyzer for competitive team building.

A fast CLI tool to analyze defensive matchups, offensive coverage, and full team composition in competitive Pokemon (Gen 9 / Scarlet & Violet type chart).

---

Install

pip install -e .

Or just run directly:

python -m typecov.cli

---

Usage

check — Defensive matchups for a type combo

typecov check Dragon            # single type
typecov check Dragon Steel      # dual type
typecov check Ghost Flying

Example output:

Defensive matchups for Dragon/Steel

  Immune (0×):   Poison
  Resist ¼×:     Grass
  Resist ½×:     Normal, Water, Electric, Flying, Psychic, Bug, Rock, Steel
  Neutral 1×:    Fire, Ghost, Dragon, Dark, Fairy
  Weak 2×:       Ice, Fighting, Ground

  Defense score: +10  (resistances - weaknesses)

---

coverage — Offensive coverage of a moveset

typecov coverage Fire Ice        # 2 move types
typecov coverage Water Grass Fire Electric   # 4 move types

Example output:

Offensive coverage for move types: Fire, Ice

  Super effective (2×+): Grass, Ice, Ground, Flying, Bug, Dragon, Steel
  Neutral (1×):          Normal, Fire, Electric, Fighting, Poison, Psychic, Rock, Ghost, Dark, Fairy
  Resisted (½×):         Water
  No effect (0×):        none

  Super-effective coverage: 7/18 types (39%)
  Blind spots (can't hit neutrally): Water

---

team — Full team analysis

Pass each Pokemon as their type(s), slash-separated for dual types:

typecov team Fire/Flying Water Grass/Poison Psychic Steel/Rock Ghost

Example output:

Team analysis (6 Pokemon)

  Pokemon              Weaknesses (2×)                          Resists
  ────────────────────────────────────────────────────────────────────────────────
  Fire/Flying          Rock(4×) Water(2×) Electric(2×)          Bug, Steel, Grass...
  Water                Electric(2×) Grass(2×)                   Fire, Water, Ice...
  ...

  Shared weaknesses:
    Electric     ███ (3 members)
    Rock         ██  (2 members)

  Collective offensive coverage (assuming STAB moves):
    Super-effective: 16/18 types
    Not super-effective against: Normal, Fairy

---

suggest — Fill team coverage gaps

Given a partial team, recommends types that plug offensive and defensive holes:

typecov suggest Fire/Flying Water
typecov suggest Fire/Flying Water Grass/Poison --limit 10

Example output:

Suggested types for your team:

  Current coverage gaps: Normal, Water, Electric, Poison, Flying, Psychic, Ghost, Dragon, Dark, Fairy
  Shared weaknesses: Electric (2), Water (1), Ice (1), Rock (1), Grass (1)

  Type         Score    New SE Coverage      Resists Team Weaknesses
  -----------------------------------------------------------------
  Ground       6        Electric, Poison     Electric, Rock
  Electric     5        Water, Flying        Electric
  Ice          5        Flying, Dragon       Ice
  Fighting     5        Normal, Dark         Rock
  Bug          5        Psychic, Dark        Grass

Scoring: each type gets points for new super-effective coverage (×2 weight) and for resisting types the team is weak to (×1 weight).

---

Options

Flag	Description
--no-color	Disable ANSI colors (for piping/scripting)
--format json	Machine-readable JSON output
--limit N	Max suggestions to show (suggest only, default: 5)

# Pipe-friendly output
typecov --no-color check Dragon Steel > matchup.txt

# JSON for scripts
typecov --format json suggest Fire/Flying Water | jq '.suggestions'

---

Type Reference

All 18 types: Normal, Fire, Water, Electric, Grass, Ice, Fighting, Poison, Ground, Flying, Psychic, Bug, Rock, Ghost, Dragon, Dark, Steel, Fairy

Type names are case-insensitive.

---

Why a CLI?

Most type coverage tools are web apps that require navigating menus. This one is:

• Fast — instant terminal feedback during team building
• Composable — pipe output, script around it
• Offline — no network needed, data is baked in

---

License

MIT