Import an axiom JSON

Got an AutomationTemplate JSON file — probably from the Claude skill — and want to run it? The Chrome extension has a built-in importer. Four clicks and you're done.

Before you start

  • An Axiom account. Free plans support import — no Pro tier required. Sign up if you don't have one yet.
  • The Axiom Chrome extension installed and signed in with the same email as your Axiom account.
  • The .json file you want to import, on your local disk. The Claude skill defaults to ~/Downloads/.

Import the JSON

Importing replaces the current automation with the one in the file. Either open the automation you want to overwrite first, or create a new one and import into that.

Heads up: importing overwrites the current automation as soon as you save. There's no undo. Make sure you're in the right automation before you import.
  1. Open the automation in the Chrome extension's builder.
  2. Click the Cog icon in the toolbar on the left.
  3. Open the Import or download section, click Select file, and pick the .json.
  4. Save the automation to apply the change.

Full reference (with screenshot + the download-to-share path): Import or download an automation .

After import — run your axiom

Your axiom is now live in your account.

  • Run it manually from the extension's run button, or set a schedule from the automation's settings.
  • Trigger it via the Claude skill: "trigger my <name>" runs the skill's run_automation workflow and prints a VNC URL you can open to watch live.
  • Trigger it via REST: see the API reference for the /api/v4/trigger endpoint contract.

Troubleshooting

The Select file button doesn't accept my JSON.
The file isn't a valid AutomationTemplate. If you generated it via the Claude skill it should already be validated — try re-running the skill against the same prompt. If you wrote the JSON by hand, open it and check it matches the documented schema.
The import succeeded but my steps are missing or wrong.
Make sure you saved the automation after importing — without saving, the import is preview-only and won't persist. Reload the builder if the UI looks stuck.
I want to share an axiom with a teammate.
From the same Import or download section, click Download to get the JSON file. Send it to your teammate; they import it the same way.