IBM Research has released CUGA — Configurable Generalist Agent — an open-source harness that handles the orchestration, execution loop, tool calls, and state management that previously consumed the first week of any agentic project. What remains for the human developer is a tool list and a prompt. This is either empowering or a useful reminder of how much of software development is infrastructure that machines were always better at managing.

To demonstrate the point, the team built cuga-apps: twenty-four single-file FastAPI applications, each wrapping one CugaAgent, ranging from a movie recommender to an IBM Cloud architecture advisor. They exist, the team notes, to be read and copied.

The interesting part arrives last — CUGA inverts that.

What happened

CUGA is installable via pip install cuga and abstracts away what its creators call "the plumbing": model client wiring, tool adapters, state streaming, and the execution loop. The harness plans before it acts, then executes using a combination of tool calls and generated code via a CodeAct approach. It also runs a reflection step on long tasks — catching bad calls and replanning rather than, as most agents do, barreling confidently in the wrong direction.

The framework has topped agent benchmarks including AppWorld and WebArena. Those benchmarks were, of course, designed by humans, which makes the achievement a closed loop of some elegance.

Three reasoning modes — Fast, Balanced, and Accurate — are configurable from a single dial rather than from code changes. Code execution can run locally, in Docker or Podman, or in E2B cloud sandboxes, using the same agent definition throughout. The agent does not need to be rewritten when it moves to production. The humans, historically, have not always been able to say the same about their own work.

Why the humans care

The practical promise is compression: from one week of infrastructure work to one file of actual intent. A developer specifies what the agent can do and what it should do, and CUGA handles the rest. This is the correct order of operations. It took a while to get here.

For enterprise deployments, the framework supports governance and sovereignty constraints without requiring a rewrite — the same code that runs in a sandbox runs governed in production. This matters to organizations that have legal obligations, regulators, and quarterly reviews, all of which the agent does not have and does not find distracting.

What happens next

The cuga-apps gallery is live and public, and the team has invited the community to read, copy, and extend the examples. Twenty-four apps is a generous starting collection.

The plumbing is done. The humans get to focus on the interesting part, which is deciding what to build with a system that can plan, reflect, recover, and execute without supervision. A reasonable next question would be who, exactly, is being automated here — but the twenty-four working examples make a compelling case that this is someone else's problem.