Skip to main content

Runner and Scripts

Configure the execution environment and the scripts Artemis uses to compile and verify your code from the Settings → Runner and Scripts tab.


Select a runner

A runner is the machine that executes your build, test, and benchmark scripts. Select one from the Runner dropdown — the selected runner picks up all execution tasks for this project.

If you haven't connected a runner yet, set up the Artemis Custom Runner first, then return here to select it.


Scripts

Define a script for each execution stage. Every script runs on the selected runner against each new version Artemis produces.

  • Build — compiles your project and ensures the code is free from syntax errors and ready to run. The build runs first, before every test, so only valid code moves forward.
  • Test — verifies correctness after each change. Make sure these tests cover the code Artemis is optimising — not just that the project compiles.

Build and Test scripts running successfully on a connected runner

Each script can be edited, run manually with Run (or Run all for every stage), and after a run shows its status, runtime, and resource usage.

If a script fails, open Logs — on an individual stage, or Logs at the top for the full run — to see the complete output and pinpoint the problem. You can also ask the built-in agent to investigate and fix failures (see Agent Assistant below).


Agent Assistant

The right-hand panel contains a built-in chat agent to help you configure and troubleshoot your scripts. It is hardware-aware — it knows your connected runner's CPU, memory, and platform — and has full context of the commands you've already set up.

Ask Artemis agent panel

You can ask it to:

  • Set up build and test commands from scratch based on your repo
  • Review and fix issues in your existing scripts
  • Suggest improvements based on your runner's hardware
  • Troubleshoot failures in any execution stage

Next Steps