← In the News

HubSpot runs its agents on one shared Java harness

Aviator: HubSpot's Agent Harness · Ze'ev Klapow, HubSpot · HubSpot Engineering, November 19, 2026

Machine-readable Download Markdown

HubSpot started looking for a common agent framework in June 2025 because each team was making its own choices and repeating the same mistakes with prompt caching, tool calling and context management. "Writing the first version of an agentic loop is easy," Klapow writes. "Scaling a harness to hundreds of teams is a different problem." Most of HubSpot's backend is Java, so the company built Aviator as a Java library with a target of an agent in under 20 lines. Agents call existing internal RPCs as tools.

Aviator stores every conversation in its own provider-neutral transcript format, so an agent can switch models mid-conversation (tool-call IDs are remapped and incompatible reasoning blocks removed), hand a transcript to another agent, or save it as JSON and resume days later on another machine. An agent can pause while it waits for a human to approve a tool call. Tools can be marked deferred and found through search: the post says Sidekick, the internal engineering assistant, "needed access to over 3,000 tools." Skills extend the SKILL.md format with load-tools and suggested-tools fields so a skill brings its tools with it. Code runs in Python and Bash sandboxes compiled to WASM that ship inside the Java library, reach only egress points HubSpot defines, and start fast enough to run "tens of thousands of short-lived environments."

The post reports that Sidekick Code, HubSpot's cloud coding agent on Aviator, "now merges more than 2,500 pull requests a week." It shows an adoption chart with the counts left out. The figures are HubSpot's own, and the post includes no code or data a reader could use to check them.

Why it matters: This is a large company's case for owning the harness layer itself rather than letting each team pick one. If you run agents on more than one model, the parts to copy are the neutral transcript, which makes model switching and pause-and-resume ordinary, and loading tools on demand once the list grows past what fits in a prompt.