Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.
Swift apple-siliconcustom-formathomebrewiosipaipadipadosiphonemetalnative-portnintendo-switchnxnativeromfsswitch-games
Notes for Claude
- First step in every clone or worktree:
git config core.hooksPath .githooks(the SessionStart hook does it when unset). Never use--no-verify, never push tomain. A PreToolUse hook in.claude/settings.jsonblocks--no-verifyand a push tomain, and the pre-push hook and the "Main rule" ruleset on GitHub block a push tomainfor every tool. See AGENTS.md. - Read AGENTS.md first: this repository's layout and rules. For engine work read engine/AGENTS.md too, upstream's guide from seedds/nxnative at the pin.
engine/is made bypython3 tools/engine.py sync(the SessionStart hook in.claude/settings.jsonruns it). - For an issue or a pull request, follow CONTRIBUTING.md, section "For AI agents and other tools", and the templates in
.github/. - A PR that changes the launcher needs before and after screenshots: see "For AI agents and other tools" in CONTRIBUTING.md for how to capture them and attach them with
gh pr create --attach. - The engine (
dm/,scripts/,docs/,ref/and upstream'sAGENTS.md) is not committed here: it is seedds/nxnative at.upstream-refplus the patch queue inpatches/, built intoengine/(git-ignored). TheAGENTS.mdat the root is this fork's own. A fix lands here as a patch and goes to seedds/nxnative as a pull request in parallel. Work inengine/: commit there, thenpython3 tools/engine.py exportturns the commits into patches with their header (see patches/README.md). Never add files underdm/,scripts/,docs/orref/at the root:pr-scopefails it and.gitignoreignores them. - Commit with your own git identity, never upstream's. Use the one configured for your clone, or your own name and email.
engine/AGENTS.mdends withgit -c user.name=seedds -c user.email=…because it is written for seedds/nxnative, where seedds is the maintainer. Do not copy that line here: it makes fork commits, and theFrom:line of patches made withtools/engine.py export, show upstream's author (six commits on 2026-10-30 did, includingv0.7.2, and patch 0033 in #230).