Dimillian/PokeSwift

Latest recorded source activity: March 16, 2026 at 08:51

SkillsMP catalog refreshed: November 2, 2026 at 18:02

skills collected: 3

GitHub stars: 363
GitHub forks: 38

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Dimillian/PokeSwift.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# PokeSwift ![PokeSwift gameplay screenshot](docs/images/pokeswift-readme-hero.png) PokeSwift is a native macOS reinterpretation of Pokemon Red built in Swift. This repository still contains the `pret/pokered` disassembly and original assets as the canonical source of truth for game data, scripts, rules, maps, text, and content coverage. The active project goal is no longer "maintain an ASM dump" by itself. The goal is to ship a fully playable macOS app from this repo using: - a native Swift engine - a native macOS app shell and UI - deterministic content extracted from the disassembly - telemetry and runtime traces that support debugging and validation ## Current Status Milestones `M1` and `M2` are complete. Today the repo includes: - a Tuist-managed Swift workspace - a deterministic Red content extraction pipeline - committed extracted runtime content under `Content/Red/` - a native macOS app that reaches `launch -> splash -> titleAttract -> titleMenu` - telemetry and runtime traces for automated debugging and validation The Swift app now targets macOS `26.0` and later. ## Run The App Primary commands: ```bash ./scripts/build_app.sh ./scripts/extract_red.sh ./scripts/launch_app.sh ``` These scripts: - generate the Tuist workspace - build the Swift targets - extract and verify Red runtime content - launch the native app For normal app usage, `./scripts/launch_app.sh` is enough. ## Project Layout - `App/` native macOS app host - `Sources/PokeCore/` headless game/runtime state - `Sources/PokeUI/` reusable SwiftUI rendering and scene components - `Sources/PokeContent/` runtime content loading and validation - `Sources/PokeExtractCLI/` deterministic extraction from the disassembly - `Sources/PokeTelemetry/` runtime snapshots and control surfaces - `Content/Red/` extracted runtime artifacts used by the app - `SWIFT_PORT.md` living port ledger for full-game scope and milestone tracking ## Source Of Truth The Swift runtime does not parse `.asm` files directly at runtime. Instead: 1. `PokeExtractCLI` reads the disassembly and source assets from this repository. 2. It writes deterministic runtime artifacts into `Content/Red/`. 3. The native app loads those extracted artifacts. This keeps the disassembly authoritative while letting the macOS app stay native and testable. ## Supplemental Item Sprites The bag UI also uses a checked-in subset of inventory item sprites sourced from [msikma/pokesprite](https://github.com/msikma/pokesprite). - Vendored source sprites live under `ThirdParty/PokeSprite/`. - The extractor copies only the referenced subset into generated runtime content under `Content/Red/Assets/items/`. - The upstream PokéSprite repository includes the sprite database and inventory icon set used for these supplemental bag assets. ## Original Disassembly And ROM Builds This repo still builds the original ROM targets: - Pokemon Red (UE) [S][!].gb `sha1: ea9bcae617fdf159b045185467ae58b2e4a48b9a` - Pokemon Blue (UE) [S][!].gb `sha1: d7037c83e1ae5b39bde3c30787637ba1d4c48ce2` - BLUEMONS.GB (debug build) `sha1: 5b1456177671b79b263c614ea0e7cc9ac542e9c4` - dmgapae0.e69.patch `sha1: 0fb5f743696adfe1dbb2e062111f08f9bc5a293a` - dmgapee0.e68.patch `sha1: ed4be94dc29c64271942c87f2157bca9ca1019c7` For the original assembly toolchain and ROM build setup, see [**docs/INSTALL.md**](docs/INSTALL.md). ## Planning And Progress - [**SWIFT_PORT.md**](SWIFT_PORT.md) is the master engineering ledger for the Swift port. - It tracks milestones, subsystem status, parity goals, telemetry requirements, and next steps. ## See Also - [**Wiki**][wiki] (includes [tutorials][tutorials]) - [**Symbols**][symbols] - [**Tools**][tools] You can find us on [Discord (pret, #pokered)](https://discord.gg/d5dubZ3). For other pret projects, see [pret.github.io](https://pret.github.io/). [wiki]: https://github.com/pret/pokered/wiki [tutorials]: https://github.com/pret/pokered/wiki/Tutorials [symbols]: https://github.com/pret/pokered/tree/symbols [tools]: https://github.com/pret/gb-asm-tools

Loading the repository README…

Skills in this repository

Software Developers

1 occupation category · 100% classified

skill

occupation

description

updated

pokeswift-extractor-contract-change

Software Developers

Investigate, implement, and validate PokeSwift extraction or shared-contract changes without breaking the source-driven pipeline. Use when work touches `PokeExtractCLI`, `PokeDataModel`, `PokeContent`, generated `Content/Red` artifacts, or any bug where the…

2026-03-16

pokeswift-tuist-refactor-guard

Software Developers

Plan, review, and execute PokeSwift refactors without breaking the Tuist workspace, target graph, or module ownership boundaries. Use when moving or splitting Swift files, reorganizing `Sources/` or `App/`, decomposing large runtime or UI files, cleaning up…

2026-03-16

pokeswift-parity-fix

Software Developers

Investigate and fix PokeSwift gameplay parity regressions against `pret/pokered` using the repo's source-driven pipeline. Use when a user reports behavior drift from Pokemon Red, asks for parity work in battle/progression/maps/save/load/audio/UI, needs…

2026-03-16

Showing 3 of 3 collected skills.