Open the simulator

Using Circuitpal with an AI agent

Give an AI assistant a skill file and it can build, run and analyse circuits in Circuitpal for you, the same way you would with the mouse.

An agent skill is a short instruction file that tells an AI assistant how to use a tool. The Circuitpal skill teaches an agent to drive the simulator through the same scripting interface described on the scripting page: it builds a circuit, runs it, reads the numbers, and explains what they mean. It does not add a chat box to the site; the agent works in your own browser, on your own page, and nothing is sent anywhere unless you ask it to share something.

Get the skill#

Save the two files in a folder called circuitpal (with references/api.md inside it) and add that folder to your assistant's skills. For Claude Code that is .claude/skills/circuitpal/ in your project or in your home folder; other assistants have their own place for custom instructions, and you can also just paste SKILL.md into the conversation.

What the agent needs#

A browser tool that can open a page and run JavaScript in it, such as a browser extension, Playwright or the browser built into your assistant app. The agent opens circuitpal.com, waits for window.Circuitpal and calls it.

What it can do#

Everything a person can do, as code, and it can read the results back:

AreaWhat the agent can do
BuildAdd any of the ${D.parts.length} parts, wire them on the 2D sheet or place them on the 3D breadboard, change values, move, rotate, lock, group, undo.
Run and readStart and stop the circuit, then read the voltage, current and power of every part, brightness and state, warnings and burnt-out parts, and what the details panel says.
MeasureOscilloscope traces with min, max, frequency and samples; frequency response (Bode), parameter sweeps and Monte Carlo runs; SPICE export and import.
SettingsBeginner or Advanced mode, theme, graphics quality, ambient temperature, tolerances and noise, simulation speed and accuracy.
LearnList and start the lessons and challenges, and read the current step.
CommunitySearch and open shared circuits, read comments, like, comment and share (when you are signed in).

Things to ask it#

Safety, privacy and moderation#