Guide · PuppyMacro 1.23.0

AI apps

Beta. AI apps in PuppyMacro are new: they work, but they may change, and an AI can get a request wrong. Every change is kept in the item's History, so you can always go back.

PuppyMacro works with the AI apps on your PC that support MCP (Model Context Protocol), like Claude Desktop, Claude Code, Visual Studio Code with GitHub Copilot and Codex. Ask in your own words, for example "in Notepad, make Ctrl+X type A" or "make a macro that opens my inventory and destroys the first 3 items": the AI makes the loop, macro or remap in PuppyMacro, ready to try. The AI and its account are your AI app's: PuppyMacro has no AI of its own.

Set it up

1. Select AI in the side rail, above Settings, and turn on Allow AI access. While it is off, AI apps can connect but every request is refused, and the AI tells you to turn it on.
2. Under Apps, select Connect on your app:
   • Claude Desktop: PuppyMacro is added to Claude Desktop's settings (claude_desktop_config.json). Restart Claude Desktop: quit it from its icon in the system tray, then open it again. Use the Claude Desktop app: claude.ai in the browser can't reach PuppyMacro.
   • Visual Studio Code: VS Code opens on the page that installs PuppyMacro's MCP server: select Install there. Then ask in Copilot Chat in Agent mode, with the model you choose there.
   • Codex: PuppyMacro is added to Codex's settings (%UserProfile%\.codex\config.toml). Restart Codex.
   • Other apps (Claude Code and any app that supports local MCP servers): Copy configuration copies the settings to paste in the app's MCP settings (the usual mcpServers format), then restart that app.
3. Once the app has started PuppyMacro's server, its row says Connected since and the time, and the status bar at the bottom of PuppyMacro's window shows its name with a green dot. Before that the row says, for example, Added. Restart Claude Desktop to connect. Select the status bar to open the AI page.

Remove takes PuppyMacro out of that app's settings. If VS Code's mcp.json has comments, PuppyMacro does not rewrite it: remove PuppyMacro in VS Code with MCP: Open User Configuration. The buttons are off while Allow AI access is off.

What the AI may do without asking

Open Allow AI access (the arrow on its right) to choose:

• Ask before deleting a loop, macro or remap (on): a PuppyMacro window, Asked by the app, asks you first.
• Ask before changing a loop, macro or remap (off): off, the AI's new and changed items are saved at once, ready to try; on, a window shows the changes first, for example Action 2 (Destroy): Delay ms 100 → 250, with Save and Cancel. Enabling and disabling count as changes.
• Ask before changing settings (on): theme, close to system tray, the global hotkeys, the overlay panel, its opacity, clicks in the panel, sound volume.
• Start PuppyMacro when an AI app needs it (on): when PuppyMacro is closed, the AI app starts it in the system tray. Off, AI apps can't use PuppyMacro while it is closed: the AI tells you to open it, and suggests Start with Windows or Close to system tray (those that are off) to keep it always available.

Whatever you choose, every change is kept: see History and Activity.

What you can ask

• Questions: which loops, macros and remaps you have, what one does, whether a key or combination is free, how something works in PuppyMacro (the AI reads this guide, of the version you have).
• New or changed loops, macros and remaps: saved as their editor's Save does, with the same checks. To change an item the AI sends only what changes (for example "every delay of 800 ms to 1200"), so even a big macro changes in seconds. One that is running stops when it changes. Then try it: the AI can't start it for you (see below).
• Delete, enable or disable a loop, macro or remap, and change settings.
• Points, apps and keys: instead of guessing, the AI can ask you to click one or more points on the screen (for clicks or moves), to click a window of an app (for Specific app), or to press a key or combination.
• A floating button for a loop or macro in Toggle mode: the AI turns on its floating button and Show in overlay, then opens the screen where you drag the button where you want it and press Enter (Esc cancels, nothing changes).
• Open a loop, macro or remap in its editor, with what the AI wants you to look at on top. What you change there is yours, saved with Save as usual.
• Share: the AI can give you a .puppyitems file with the items you ask for, or import the items of a file you paste, new and disabled, and open PuppyMacro's Import and Export windows (see Share loops, macros and remaps). With several items, it asks which ones first.
• Stop all: the AI can stop every running loop and macro.

When the AI needs you on the screen

Before you click points or an app, or place a floating button, a PuppyMacro window shows in the middle of the screen, on top of everything, what the AI wrote for you: a title, a short description (what it is making and why) and, under Instructions, the steps, numbered, in the language you write to the AI in. Drag it anywhere if it covers what you need. Clicking or dragging it never takes the focus from your game or app: get the screen ready first (open the game's inventory, the window to click), then press Enter or select Start. Enter works from any app and the app does not get it; Esc cancels. Then click the points: next to the cursor a light blue label says which point to click now, with several the bar shows 2 / 3 and a number marks each point clicked. For a key, the window shows the same title, description and steps and waits for the key.

Every window the AI opens appears in the middle of the screen. When the AI makes a new loop or macro, it asks only what matters for it (how fast, which keys or items), then writes in the chat the exact steps it will play, each key and click and what it does, and waits for your OK before asking for points. Once it is saved, it offers the extras it does not have yet: a hotkey, the overlay and a floating button, a sound, a specific app.

• One request that needs you at a time. A window closes by itself, with nothing changed, when nobody uses PuppyMacro for 5 minutes.
• While you have an editor or a dialog of PuppyMacro open, the AI is told to wait until you close it.
• If Windows only flashes a PuppyMacro window in the taskbar, select it there.

What AI apps cannot do

• Start or test loops and macros: their keys and clicks would go to the window in front, usually the AI app's chat. Start them yourself, with the Play button on their card, their hotkey or overlay mode.
• Change Start with Windows, Allow AI access and what it may do, backups and updates.
• Reach PuppyMacro from a website: claude.ai, ChatGPT and other AI apps in the browser or on the phone can't connect to an app on your PC. Use an app installed on the PC.

Activity

Recent activity on the AI page shows the last requests: when, which app, what it asked and how it ended (Saved, Done, Cancelled, Refused…). Restore on a change or deletion made by an AI app puts back what was there before (the row then says Restored). View all opens the AI activity window, with Period, App, Type, Result and Search; select a request to see what was saved, and Restore it. The activity is kept on this PC, the newest requests up to 20 MB; Clear history deletes it.

Privacy

PuppyMacro sends nothing to AI services. What the AI app reads through PuppyMacro (your loops, macros, remaps and settings, the names of the open apps, the points and keys you give) goes to that app's provider, under its own privacy policy. Turn off Allow AI access to stop every request.