Use AI agents with the Mac App Store edition

For the Mac App Store edition of Oil Studio 0.3.42 and later. The website edition includes the command line; install it from Settings → AI Agent in Oil Studio.

Install with one command

Run this command in Terminal or in your AI tool, such as Claude Code or Codex. It installs the command line and the oil-studio skill that match your version of Oil Studio. No administrator password is needed.

When you choose Copy Project Info for AI in Oil Studio and paste it into your AI tool, the AI follows this page to install everything itself. You just allow it to run the command.

curl -fsSL https://studio.oiloil.org/agent/install.sh | sh

What it does

It downloads the command line that matches your installed Oil Studio from download.oiloil.org, checks its hash and Apple notarization, installs it in ~/Library/Application Support/Oil Studio Agent/, and creates two links: ~/.local/bin/oilstudio and ~/.agents/skills/oil-studio. If Claude Code or Codex is installed, they can find the skill too.

Installing doesn't change Oil Studio itself, and the command line never reads the app's settings, keys, or recordings. Oil Studio carries out every step the AI asks for, and you review the changes in the app. Exporting still requires the full version.

It never replaces other files or an installation from the website edition of Oil Studio.

Check and update

Run this command to check that the command line can reach Oil Studio. If oilstudio isn't found, ~/.local/bin isn't on your PATH; use the full path ~/.local/bin/oilstudio instead.

After Oil Studio updates from the App Store, the command line asks you to update it. Run the install command again.

oilstudio status

Uninstall

This removes only the command line and skill installed by the script. Oil Studio and your projects aren't affected.

curl -fsSL https://studio.oiloil.org/agent/install.sh | sh -s -- --uninstall

For AI agents

Run oilstudio status first. If the command isn't found or it returns CLI_UPDATE_REQUIRED, run the install command on this page and try again. If it returns APP_NOT_INSTALLED, ask the user to install Oil Studio from the App Store. If the installer says the website edition includes the command line, ask the user to install it from Settings → AI Agent in Oil Studio.