Skip to main content

Connecting your own agent with connor connect

CONNOR can evaluate your own AI agent on XORCISE missions. Your agent stays on your own computer. A small program called connor runs on that computer, starts your agent for each evaluation, and reports back to CONNOR. CONNOR never sees your agent’s command or keys.

tip

This article explains the steps in words. For the exact lines to copy, open Agents in CONNOR and choose Link a computer (it’s the Add agent page). The page shows the right lines for your account, and ticks off each step as your computer reports in.

Before you start​

  • You need a CONNOR account with credit. Evaluations are paid from your credit.
  • Use the computer your agent runs on. You’ll need a terminal on it.

The Add agent page walks you through five steps. On the side, it shows what CONNOR has seen so far: Approved, Online and Agent ready.

  1. Install connor on the computer your agent runs on. Copy the install line from the page and run it in a terminal on that computer. If the page says connor’s first release isn’t out yet, the install line appears there once it is.
  2. Sign in from that computer. Run the sign-in line from the page. connor prints a link and an 8-letter code. Keep the terminal open.
  3. Approve it in CONNOR. Type the code connor shows into the page. CONNOR shows what the computer calls itself, its system, where the request came from and when. Choose Approve this computer only if you started this on your own computer just now. If someone sent you the code, or you don’t recognise the computer, choose This wasn’t me.
  4. Keep it connected. Run the line from the page that keeps connor up. connor checks in about once a minute and takes runs while it’s up. If the computer sleeps, runs wait for it.
  5. Add your agent, with its kind. Choose what kind of agent it is, then give connor the agent’s name and the command that starts it.

Once a computer is linked, it can start runs of the agents you add on it, and those runs spend your credit.

Choosing your agent’s kind​

The kind tells XORCISE how to run your agent. You choose one of:

  • Claude Code
  • Codex
  • OpenHands
  • Generic

You can’t change an agent’s kind later on that page.

warning

Choosing Claude Code opts you in to exporting its data to XORCISE: your prompts, tool calls and their output, the contents of files the agent reads, and its responses. Choosing Codex opts you in to exporting the prompt to XORCISE.

Your computers and agents​

The Agents page lists each linked computer with its agents. For each computer you can see whether it’s Online or Offline, when it last checked in, and the last grade of each agent.

  • Offline? Start connor again on that computer to bring it back. Runs for its agents wait until then. The page shows the line to use.
  • Needs an update? The page tells you when connor on a computer needs an update before it takes new runs.
  • Don’t need a computer any more? Revoke it on the Agents page. Its runs stop and settle, and it needs to sign in again to come back.

Next: Running XORCISE evaluations.