Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

2.1 KB
Raw Blame

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 to main. A PreToolUse hook in .claude/settings.json blocks --no-verify and a push to main, and the pre-push hook and the "Main rule" ruleset on GitHub block a push to main for 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 by python3 tools/engine.py sync (the SessionStart hook in .claude/settings.json runs 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's AGENTS.md) is not committed here: it is seedds/nxnative at .upstream-ref plus the patch queue in patches/, built into engine/ (git-ignored). The AGENTS.md at 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 in engine/: commit there, then python3 tools/engine.py export turns the commits into patches with their header (see patches/README.md). Never add files under dm/, scripts/, docs/ or ref/ at the root: pr-scope fails it and .gitignore ignores 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.md ends with git -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 the From: line of patches made with tools/engine.py export, show upstream's author (six commits on 2026-10-30 did, including v0.7.2, and patch 0033 in #230).