PS1 emulator + AI test harness

Play PlayStation (PS1) games and homebrew in the browser, or let an AI agent test them through an MCP server. Everything runs offline from the bundled data/ folder (EmulatorJS with the PCSX-ReARMed core, plus the free OpenBIOS, so no Sony BIOS is needed).

• Play: see below.
• Make or test games with an AI agent: see harness/README.md. In Claude Code: /plugin marketplace add sandrinsol/ps1-test, then /plugin install ps1-test@ps1-test. The agent can build your game, read its variables by name, see every GPU command a frame sends, check it against hardware rules, and start new games from the PSn00bSDK template.

Play

Browsers won't load the emulator from file://, so serve the folder:

python3 -m http.server 8000    # or double-click start.command on macOS

Open http://localhost:8000 and click Try the demo (a small game built from the template, in demo/), or Load disc or EXE and pick a disc image (a .cue together with its .bin files, or a single .bin/.iso), a homebrew .exe or a .zip. Choose the bundled OpenBIOS, the built-in HLE BIOS, or your own BIOS dump (best compatibility; it never leaves your computer).

Action	Key
D-pad	W A S D
Triangle / Square / Cross / Circle	I / J / K / L
L1 / L2	Q / E
R1 / R2	U / O
Start / Select	Enter / V
Left stick	T F G H
Right stick	Arrow keys

The bar at the bottom has pause, save states, fullscreen, volume and settings (including gamepads and the controller type). On a phone or tablet an on-screen PlayStation pad appears (D-pad, △ ○ ✕ □, L1/L2/R1/R2, Start/Select).

• Drag and drop a disc image, EXE or zip onto the page to play it (a .cue together with its .bin files).
• Memory card (above the game): see the saves on the card (title, game ID, blocks, icon), export it as .mcr, import a card (.mcr/.mcd/.gme/.vgs, or drop it on the running game) or format it. Cards are kept in the browser's storage between visits.
• Install it from the browser's menu ("Install app" / "Add to Home Screen"): after the first visit the page, the emulator and the demo work offline.

To host it, deploy the folder as a static site (no build step). It's set up for Vercel: import the repository at vercel.com/new (or run npx vercel in the folder) and keep the defaults — vercel.json skips the install and build, serves the folder as is and sets cache headers for the core files, and .vercelignore leaves the test harness and templates out of the deployment. Each deployment (including PR previews) is then smoke-tested by the deployment workflow: it opens the deployed page, starts the demo and checks it draws. If previews sit behind Vercel Authentication, add the project's "Protection Bypass for Automation" secret to the repository as VERCEL_AUTOMATION_BYPASS_SECRET.

License

GPL-3.0-or-later, as it bundles EmulatorJS (GPL-3.0) and PCSX-ReARMed (GPL-2.0+). See LICENSE and NOTICE.md. No BIOS dumps or commercial games are included; don't commit them.