{"id":18377409,"url":"https://github.com/digitalghost-dev/poke-cli","last_synced_at":"2026-04-29T23:12:00.727Z","repository":{"id":242122838,"uuid":"807742259","full_name":"digitalghost-dev/poke-cli","owner":"digitalghost-dev","description":"A hybrid CLI/TUI tool written in Go for viewing Pokémon data from the terminal! Also doubles as a Data Engineering project.","archived":false,"fork":false,"pushed_at":"2026-04-28T22:11:04.000Z","size":20551,"stargazers_count":175,"open_issues_count":4,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-28T23:22:24.675Z","etag":null,"topics":["charm","charmbracelet","cli","data","data-engineering","go","pokemon","terminal","terminal-based","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/digitalghost-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-05-29T17:24:13.000Z","updated_at":"2026-04-26T17:26:38.000Z","dependencies_parsed_at":"2025-12-19T13:01:37.050Z","dependency_job_id":"b815988c-363d-48ac-999c-db8180fe6a8d","html_url":"https://github.com/digitalghost-dev/poke-cli","commit_stats":null,"previous_names":["digitalghost-dev/poke-cli"],"tags_count":76,"template":false,"template_full_name":null,"purl":"pkg:github/digitalghost-dev/poke-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalghost-dev%2Fpoke-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalghost-dev%2Fpoke-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalghost-dev%2Fpoke-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalghost-dev%2Fpoke-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalghost-dev","download_url":"https://codeload.github.com/digitalghost-dev/poke-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalghost-dev%2Fpoke-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32447383,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"ssl_error","status_checked_at":"2026-04-29T22:10:49.234Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["charm","charmbracelet","cli","data","data-engineering","go","pokemon","terminal","terminal-based","tui"],"created_at":"2024-11-06T00:28:02.932Z","updated_at":"2026-04-29T23:12:00.720Z","avatar_url":"https://github.com/digitalghost-dev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg width=\"425\" src=\"poke-cli.png\" alt=\"pokemon-logo\"/\u003e\n    \u003ch4\u003e\u003c/h4\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/digitalghost-dev/poke-cli?style=flat-square\u0026logo=git\u0026logoColor=FFCC00\u0026label=Release%20Version\u0026labelColor=EEE\u0026color=FFCC00\" alt=\"version-label\"\u003e\n    \u003cimg src=\"https://img.shields.io/docker/image-size/digitalghostdev/poke-cli/v1.10.0?arch=arm64\u0026style=flat-square\u0026logo=docker\u0026logoColor=FFCC00\u0026labelColor=EEE\u0026color=FFCC00\" alt=\"docker-image-size\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/digitalghost-dev/poke-cli/ci.yml?branch=main\u0026style=flat-square\u0026logo=github\u0026logoColor=FFCC00\u0026label=CI\u0026labelColor=EEE\u0026color=FFCC00\" alt=\"ci-status-badge\"\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/digitalghost-dev/poke-cli/go_test.yml?style=flat-square\u0026logo=go\u0026logoColor=00ADD8\u0026label=Tests\u0026labelColor=EEE\u0026color=00ADD8\" alt=\"tests-label\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/go-mod/go-version/digitalghost-dev/poke-cli?style=flat-square\u0026logo=Go\u0026labelColor=EEE\u0026color=00ADD8\" alt=\"go-version\"/\u003e\n    \u003cimg src=\"https://img.shields.io/codecov/c/github/digitalghost-dev/poke-cli?token=05GBSAOQIT\u0026style=flat-square\u0026logo=codecov\u0026logoColor=00ADD8\u0026labelColor=EEE\u0026color=00ADD8\" alt=\"codecov\"/\u003e\n\u003c/div\u003e\n\n## Pokemon CLI\n`poke-cli` is a hybrid of a classic CLI and a modern TUI tool for viewing VG and TCG data about Pokémon!\n\nView the [documentation](https://docs.poke-cli.com) on the data infrastructure in [card_data/](https://github.com/digitalghost-dev/poke-cli/tree/main/card_data) if you're interested.\n\n* [Demo](#demo)\n* [Installation](#installation)\n* [Usage](#usage)\n* [Roadmap](#roadmap)\n* [Tested Terminals](#tested-terminals)\n\n---\n\n## Demo\n### Video Game Data\n\n![demo-vg](https://dc8hq8aq7pr04.cloudfront.net/demo-v1.6.0.gif)\n\n### Trading Card Game Data\n\n![demo-tcg](https://dc8hq8aq7pr04.cloudfront.net/poke-cli-card-v1.8.8.gif)\n\n---\n\n## Installation\n\n* [Homebrew](#homebrew)\n* [Scoop](#scoop)\n* [Linux Packages](#linux-packages)\n* [Docker Image](#docker-image)\n* [Binary](#binary)\n* [Source](#source)\n\n\n### Homebrew\n1. Install the Cask:\n    ```bash\n    brew install --cask digitalghost-dev/tap/poke-cli\n    ````\n2. Verify installation:\n    ```bash\n    poke-cli -v\n    ```\n\n### Scoop\n1. Add the bucket:\n    ```bash\n    scoop bucket add digitalghost https://github.com/digitalghost-dev/scoop-bucket.git\n    ```\n\n2. Install poke-cli:\n    ```bash\n    scoop install poke-cli\n    ```\n   \n3. Verify installation:\n    ```bash\n    poke-cli -v\n    ```\n\n### Linux Packages\n[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith\u0026style=flat-square)](https://cloudsmith.com)\n\nThis package repository is generously hosted by Cloudsmith.\nCloudsmith is a fully cloud-based service that lets you easily create, store, and share packages in any format, anywhere.\n\n1. Run the **Repository Setup** script first for the correct Linux distribution.\n2. Run the corresponding **Installation Command** afterward.\n\n| Package Type | Distributions                     | Repository Setup                                                                                                                        | Installation Command                   |\n|:------------:|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|\n|    `apk`     | Alpine                            | `sudo apk add --no-cache bash \u0026\u0026 curl -1sLf 'https://dl.cloudsmith.io/basic/digitalghost-dev/poke-cli/setup.alpine.sh' \\| sudo -E bash` | `sudo apk add poke-cli --update-cache` |\n|    `deb`     | Ubuntu, Debian                    | `curl -1sLf 'https://dl.cloudsmith.io/public/digitalghost-dev/poke-cli/setup.deb.sh' \\| sudo -E bash`                                   | `sudo apt-get install poke-cli`        |\n|    `rpm`     | Fedora, CentOS, Red Hat, openSUSE | `curl -1sLf 'https://dl.cloudsmith.io/public/digitalghost-dev/poke-cli/setup.rpm.sh' \\| sudo -E bash`                                   | `sudo yum install poke-cli`            |\n\n### Docker Image\n\n1. Install [Docker Desktop](https://www.docker.com/products/docker-desktop/).\n2. Once installed, use the command below to pull the image and run the container!\n   * `--rm`: Automatically remove the container when it exits. \n     * Optional.\n   * `-i`: Interactive mode, keeps STDIN open for input.\n     * Necessary.\n   * `-t`: Allocates a terminal (TTY) for a terminal-like session.\n     * Necessary.\n3. Choose how to interact with the container:\n   * Run a single command and exit:\n    ```bash\n    docker run --rm -it digitalghostdev/poke-cli:v1.10.0 \u003ccommand\u003e [subcommand] [flag]\n    ```\n   * Enter the container and use its shell:\n    ```bash\n    docker run --rm -it --name poke-cli --entrypoint /bin/sh digitalghostdev/poke-cli:v1.10.0 -c \"cd /app \u0026\u0026 exec sh\"\n   # placed into the /app directory, run the program with './poke-cli'\n   # example: ./poke-cli ability swift-swim\n    ```\n\n\u003e [!NOTE]\n\u003e The `card` command renders TCG card images using your terminal's graphics protocol. When running inside Docker, pass your terminal's environment variables so image rendering works correctly:\n\u003e ```bash\n\u003e # Kitty\n\u003e docker run --rm -it -e TERM -e KITTY_WINDOW_ID digitalghostdev/poke-cli:v1.10.0 card\n\u003e\n\u003e # WezTerm, iTerm2, Ghostty, Konsole, Rio, Tabby\n\u003e docker run --rm -it -e TERM -e TERM_PROGRAM digitalghostdev/poke-cli:v1.10.0 card\n\u003e\n\u003e # Windows Terminal (Sixel)\n\u003e docker run --rm -it -e WT_SESSION digitalghostdev/poke-cli:v1.10.0 card\n\u003e ```\n\u003e If your terminal is not listed above, image rendering is not supported inside Docker.\n\n### Binary\n\n1. Head to the [releases](https://github.com/digitalghost-dev/poke-cli/releases) page of the project.\n2. Choose a version to download. The latest is best.\n3. Choose an operating system and click on the matching zipped folder to start the download.\n4. Extract the folder. The tool is ready to use.\n5. Either change directories into the extracted folder or move the binary to a chosen directory.\n6. Run the tool!\n\n\u003e [!IMPORTANT]\n\u003e For macOS, you may have to allow the executable to run as it is not signed. Head to System Settings \u003e Privacy \u0026 Security \u003e scroll down and allow executable to run.\n\n\u003cdetails\u003e\n\n\u003csummary\u003eView Image of Settings\u003c/summary\u003e\n\n![settings](https://poke-cli-s3-bucket.s3.us-west-2.amazonaws.com/macos_privacy_settings.png)\n\n\u003c/details\u003e\n\n\n#### Example usage\n  ```bash\n  # Windows\n  .\\poke-cli.exe pokemon charizard --types --abilities\n   \n  # Unix\n  .\\poke-cli ability airlock --pokemon\n  ```\n\n### Source\n\n1. Run the following command:\n   ```bash\n   go install github.com/digitalghost-dev/poke-cli@latest\n   ```\n2. The tool should be ready to use if `$PATH` is set up.\n\n\n---\n## Usage\nBy running `poke-cli [-h | --help]`, it'll display information on how to use the tool or check out the [docs](https://docs.poke-cli.com/)!\n```\n╭───────────────────────────────────────────────────────────────╮\n│Welcome! This tool displays data related to Pokémon!           │\n│                                                               │\n│ USAGE:                                                        │\n│    poke-cli [flag]                                            │\n│    poke-cli \u003ccommand\u003e [flag]                                  │\n│    poke-cli \u003ccommand\u003e \u003csubcommand\u003e [flag]                     │\n│                                                               │\n│ FLAGS:                                                        │\n│    -h, --help      Shows the help menu                        │\n│    -l, --latest    Prints the latest version available        │\n│    -v, --version   Prints the current version                 │\n│                                                               │\n│ COMMANDS:                                                     │\n│    ability         Get details about an ability               │\n│    berry           Get details about a berry                  │\n│    card            Get details about a TCG card               │\n│    item            Get details about an item                  │\n│    move            Get details about a move                   │\n│    natures         Get details about all natures              │\n│    pokemon         Get details about a Pokémon                │\n│    search          Search for a resource                      │\n│    speed           Calculate the speed of a Pokémon in battle │\n│    tcg             Get details about TCG tournaments          │\n│    types           Get details about a typing                 │\n│                                                               │\n│ hint: when calling a resource with a space, use a hyphen      │\n│ example: poke-cli ability strong-jaw                          │\n│ example: poke-cli pokemon flutter-mane                        │\n│                                                               │\n│ ↓ ctrl/cmd + click for docs/guides                            │\n│ docs.poke-cli.com                                             │\n╰───────────────────────────────────────────────────────────────╯\n```\n\n---\n\n## Roadmap\nBelow is a list of the planned/completed commands and flags:\n\n- [x] `ability`: get data about an ability.\n    - [x] `-p | --pokemon`: display Pokémon that learn this ability.\n- [x] `berry`: get data about a berry.\n- [ ] `card`: get data about a TCG card.\n    - [x] add mega evolution data\n    - [x] add scarlet \u0026 violet data\n    - [x] add sword \u0026 shield data\n    - [x] add sun \u0026 moon data\n    - [ ] add x \u0026 y data\n- [x] `item`: get data about an item.\n- [x] `move`: get data about a move.\n    - [ ] `-p | --pokemon`: display Pokémon that learn this move.\n- [x] `natures`: get data about natures.\n- [x] `pokemon`: get data about a Pokémon.\n    - [x] `-a | --abilities`: display the Pokémon's abilities.\n    - [x] `-d | --defense`: display the Pokémon's type defences.\n    - [x] `-i | --image`: display a pixel image of the Pokémon.\n    - [x] `-s | --stats`: display the Pokémon's base stats.\n    - [x] `-m | --moves`: display learnable moves.\n- [ ] `search`: search for a resource \n    - [x] `ability`\n    - [ ] `berry`\n    - [ ] `item`\n    - [x] `move`\n    - [x] `pokemon`\n- [x] `speed`: compare speed stats between two Pokémon.\n- [x] `tcg`: get data about TCG tournaments.\n- [x] `types`: get data about a specific typing.\n\n---\n## Tested Terminals\n| Terminal           | OS                            | Status | Issues                                                                            |\n|--------------------|-------------------------------|:------:|-----------------------------------------------------------------------------------|\n| Alacritty          | macOS, Ubuntu, Windows        |   🟡   | No support for TCG images                                                         |\n| Foot               | Ubuntu, Fedora                |   🟢   | None                                                                              |\n| Ghostty            | macOS                         |   🟢   | None                                                                              |\n| iTerm2             | macOS                         |   🟢   | None                                                                              |\n| Kitty              | macOS, Ubuntu, Debian, Fedora |   🟢   | None                                                                              |\n| Rio                | macOS                         |   🟢   | None                                                                              |\n| Tabby              | Ubuntu                        |   🟢   | None                                                                              |\n| Terminal (Alpine)  | Alpine                        |   🟡   | Some colors aren't supported\u003cbr\u003e`pokemon \u003cname\u003e --image=xx` flag has pixel issues |\n| Terminal (Linux)   | Ubuntu, Debian, Fedora        |   🟡   | No support for TCG images                                                         |\n| Terminal (macOS)   | macOS                         |   🟠   | No support for TCG images\u003cbr\u003e`pokemon \u003cname\u003e --image=xx` flag has pixel issues    |\n| Terminal (Windows) | Windows                       |   🟢   | None                                                                              |\n| WezTerm            | macOS, Windows                |   🟡   | Windows version has issues with displaying TCG images                             |","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalghost-dev%2Fpoke-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalghost-dev%2Fpoke-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalghost-dev%2Fpoke-cli/lists"}