Connect an AI App

On the Mac and on Windows, an AI app such as Claude Code or Claude Desktop can work in the projects you have open in Pyxen: read your code, check it, run your game to test it, and change it. You see every change in Pyxen as it happens, and you can undo it.

Connect an AI App is part of Pyxen, full licence, on the Mac and on Windows. It is off until you turn it on.

Turn it on

Open Pyxen › Settings… (on Windows, Edit › Settings…) and choose AI, then turn on Let AI apps on this computer use Pyxen. The Status row says what is happening: Waiting for an AI app, then Connected to … once an app is talking to Pyxen.

Pyxen listens only while the setting is on and Pyxen is open. Turn it off and every connection closes.

Add Pyxen to your AI app

Settings › AI copies the setup for you, with everything filled in.

Claude Code

1. Choose Copy Command for Claude Code.
2. Paste the command in Terminal (on Windows, in PowerShell or Windows Terminal) and press Return. It adds Pyxen to Claude Code for every folder you work in.
3. In Claude Code, /mcp lists pyxen and its tools.
4. Ask it something about your game: “Add a double jump to the game open in Pyxen, and test it.”

Claude Desktop

1. Choose Copy Setup for Claude Desktop.
2. In Claude Desktop, open Settings › Developer › Edit Config and paste the lines into the file. If it already lists servers, add the pyxen part beside them.
3. Quit Claude Desktop and open it again.

Claude Desktop starts Pyxen itself to reach the app you have open, so the file holds no token. Keep Pyxen open with the setting on.

Another AI app

An app that connects to an address: choose Copy Address and Token, and give the app the address and the token, sent as Authorization: Bearer …. An app that only starts servers as a command: give it Pyxen itself with --mcp after it, as Claude Desktop’s setup does.

The first time an app connects

On the Mac, the first time an AI app asks to work in your projects, Pyxen asks you, in its own window: Claude wants to work in Pyxen, with what it will be able to do. Choose Allow, and Pyxen remembers it: that app isn’t asked again. Choose Don’t Allow, and the app is told you said no; it is asked again the next time it connects. Its question waits two minutes for you, then the app is told to try again. If Pyxen is behind another app, its icon bounces in the Dock.

On Windows, Pyxen doesn’t ask yet: an app you set up connects as soon as the setting is on.

What the AI app can do

• List your projects as Pyxen’s home shows them, and work in any open one. Left unnamed, it works in the window in front. To open a closed project, it asks you first: Claude wants to open Bat Cave, with Open and Don’t Open. The project opens in a window behind yours, so you keep typing where you are. Allow for this session lets it open others without asking until it disconnects.
• Read your files, your project’s settings and the components your scripts use.
• Check code with the Pyxen Script checker. Code that doesn’t check never lands: the app gets the line and the reason, and tries again.
• Run your game without a window, with keys and mouse moves by frame, and read the console, the entities and a picture of any frame, drawn as the Preview draws it. Your own game in the Preview is never paused or touched.
• Look at your game as the Preview shows it now, or at any frame Pyxen keeps.
• Travel back through the last 300 frames of your game and of its own runs, frame by frame, as the time-travel debugger does, and compare a run before and after a change. Your Preview stays on the frame you chose.
• Search the reference, the manual and the snippets, so it writes Pyxen Script the way Pyxen does.
• Change scripts, Project Settings and packs, and add files.
• Add mechanics, and change their settings.

On Windows, it works in the projects open in Pyxen’s windows only: it can’t open a closed project yet.

Follow what it does

On the Mac, while an app works in a project, that window’s toolbar says so: Claude · working, with Stop. Click the name to open the Assistant pane: each step it took (Read main.py, Checked: no problems, Ran it on its own: 90 frames) and each change it made, with the files and the lines it changed.

Its changes go into your project as it makes them. A code pane showing a changed file shows the change at once, and Edit › Undo (Ctrl+Z) there takes it back. A running game shows Code changed · Reload.

• Undo it. Right after its change, Edit › Undo Claude’s Change (⌘Z) takes the whole change back in one step, in every file it touched; Pyxen asks first when it touched several. Once you edit, ⌘Z undoes your own edits again.
• Revert in the Assistant pane takes back any of its changes, as long as you haven’t edited its files since. The app is told you reverted it.
• Stop, in the toolbar or the Assistant pane, refuses its next requests in this project and tells it to ask you before it goes on. It works again on its next turn, when you ask it something new.

On Windows, the toolbar’s name, the Assistant pane and Undo Claude’s Change aren’t there yet.

Ask before changing the project. On the Mac, to decide before anything changes, turn on Settings › AI › Ask before changing the project (it’s off by default). The app’s changes then wait in the Assistant pane as one proposal, A change waiting for you, with the files and the lines it would change. Your project stays as it was until you choose, while the app reads and runs its proposal. Accept puts it in your project as one change, which you can undo or revert like any other; Reject drops it, and the app is told. If you edit one of its files meanwhile, only Reject is left: ask the app again.

What it can’t do

It works only inside the projects open in Pyxen’s windows. It never reaches a file outside the project, the network, Pyxen’s own Settings or your licence. On the Mac, a closed project is listed by its name only: it isn’t read until you let it open. On Windows, only open projects are listed.

Your privacy

The connection stays on your computer: Pyxen listens on this computer only, every request needs the token, and requests from web pages are refused. On Windows, the token is kept so that only your Windows account can read it. Pyxen sends nothing to us. What you ask the AI app follows that app’s own terms.

New Token in Settings › AI makes a new token and disconnects the apps that use the old one. Claude Code then needs the new command; Claude Desktop’s setup keeps working.

Tips

• Ask the AI app to run the game and look at the result after a change. It can hold keys for a number of frames, read where things are and look at a picture of the frame, which catches most mistakes.
• Pyxen works with any AI model, and works best with capable ones.
• Connect an AI App is on the Mac, with the Full Licence.