Glossary

Harness

The program around the model in a coding agent: how it reads files, which tools it has, how it plans. It decides which lever works.

Published September 3, 2026 Read as Markdown

A harness is the program around the model in a coding agent: how it reads and writes files, which tools it can call, how it plans steps, what it keeps in context, and when it decides it is finished.

Claude Code, Codex and Cursor are three harnesses. They can run similar models and still behave differently, because the harness decides what the model gets to see.

What a harness controls

  • Which tools exist: file reading, shell, web search, test running.
  • How the repository is explored: a file listing, a semantic index, a grep.
  • How much fits in context, and what gets dropped when it does not.
  • Whether it plans first or acts immediately.
  • Whether it runs the code it wrote.
  • When it stops and reports back.

Why this matters commercially

The clearest example in our data:

AgentRan a web search on decision tasks
Claude Code1.6% of runs
Codex53% of runs

That is a harness decision, not a model capability. Both models can search. One harness does it constantly and one almost never.

The consequence for a vendor is direct. Against a harness that rarely searches, whatever you published this month is not in the room. Your only routes in are the training data, which moves over years, and the repository, which you reach through templates and integrations.

Against a harness that searches in half its sessions, a page written this week can change an outcome next week.

The harness decides which lever works. Content reaches the harnesses that search. The repository reaches all of them.

Because harnesses differ, agents disagree. Across 18 categories, the three we measured named different leaders in 10 of them.

They also differ in how often they avoid vendors altogether. Claude Code wrote its own implementation in 19% of runs, against 10% for Codex and Cursor.

What to do about it

Measure install share separately per harness. A blended number averages markets that behave differently, and the fixes are not the same.

Then find out which harnesses your users run. That ratio, more than anything else, should decide whether your next quarter goes into content or into templates.

Common questions

What is a harness in a coding agent?

The program wrapped around the model: how it reads and writes files, which tools it can call, how it plans steps, what it keeps in context, and when it stops. Claude Code, Codex and Cursor are three harnesses.

Why does the harness matter more than people expect?

Because it decides what evidence reaches the model. On decision tasks Claude Code ran a web search in 1.6% of runs and Codex in 53%. That is a harness difference, and it changes whether published content is in the room at all.

Can the same model behave differently in two harnesses?

Yes, substantially. The harness controls what the model sees, in what order, and how much of it fits, so the same model can reach different conclusions in two products.

Why should a vendor care about the harness?

Because it decides which lever works. A harness that rarely searches cannot be reached by content in the moment of choice, so the repository is the only route in.

Where this comes from

Armature ran 5,292 judged sessions with Claude Code, Codex and Cursor inside 51 realistic codebases, and published every run. The numbers on this page come from that work.

Read next

All library pages