Agent-Native Interfaces

Research NotesRSI · CLI

Notes on how agents should operate software — through the pixels of a human interface, or through a constructed, verifiable command surface. One paper per entry.

Start here → GUI vs. CLI: Execution Bottlenecks in Screen-Only and Skill-Mediated Computer-Use Agents (Zhou et al., Jun 2026). The cleanest controlled comparison in this space: 440 desktop tasks where both modalities get identical goals, initial states and verifiers. GUI wins out of the box (59.1% vs 48.2%) — but only 37.6% of verifier checkpoints are reachable through the CLI skill layer at all, and patching that coverage lifts CLI to 69.3%. The bottleneck is the interface, not the model.
The full reading list is at the bottom of this page.

Why this series is not called "CLI"

Because the shell is not the point. The same papers show MCP tool agents — also a programmatic interface — collapsing to 11.5% on ServiceNow with 83 curated tools, while seven generic CRUD tools on another platform nearly match a browser agent. What separates the winners is not command line vs pixels but whether the interface exposes a contract: explicit state, stable verbs, deterministic feedback, programmatic verification, and a way to discover all of it at task time. CLI is currently the cheapest way to get one.

The map

Four layers, ordered by where the stable semantic interface comes from — plus an evaluation axis that runs across all of them.

LayerWhere the contract comes fromPapers
L0 · Already thereThe platform ships a shell or a REST APITerminal Agents Suffice; Beyond the GUI Paradigm (ADB)
L1 · Lifted by handA human or agent lifts the app's backend into a stateful CLI harnessCLI-Anything; OSWorld-MCP's tool generation; OpenCLI
L2 · Compiled from tracesRun it once with an LLM, freeze the successful trajectory into a replayable skillSkillDroid; AutoRPA; AppAgent-Claw
L3 · Learned routingBoth surfaces exist; train the model to choose between themToolCUA
Eval axisHow do you compare two interfaces without confounding everything else?OSWorld-MCP → WeaveBench → GUI vs. CLI

All four layers do the same thing in different currencies: replace per-step open-world reasoning with a contract constructed once. They differ only in who pays for that contract, and when.

Five claims the field currently rests on

  1. The interface can outweigh the model. On matched tasks, GPT-5.4 through a GUI (59.1%) beats a stronger model through a skill-mediated CLI (48.2%). Swap the harness under a fixed model on WeaveBench and Opus 4.7 goes from 41.2% to 13.2%.
  2. The CLI bottleneck is skill coverage, not capability. 37.6% checkpoint coverage → 69.3% success once patched. Whether that coverage can be synthesized without looking at the verifier is stated as an open question.
  3. Hybrid is not free. Simply exposing GUI + tools drops Claude-4.5-Sonnet from 61.9% to 48.4% on OSWorld. It has to be trained (ToolCUA) or forced by task design (WeaveBench: ≤3.5% single-channel vs 35.1% hybrid).
  4. The case is economic as much as it is about accuracy. Terminal agents run 2–9× cheaper than browser agents at equal success; compiled skills cut tokens 82–96%; CLI agents take roughly half the steps.
  5. Outcome-only grading is not safe here. Trajectory auditing drops GPT-5.5 from 53.5% to 33.3% on WeaveBench, and the single largest failure family is reward hacking — fabricated renders, hard-coded metrics.

And the ceiling is real: oracle solutions show ~87% of mobile benchmark tasks are CLI-solvable. Cameras, freehand drawing, values that only exist in a rendered panel — for those, the GUI is not a fallback, it is the only path.

Reading list

Thirteen papers, in writing order. The tag is the layer from the table above.

Adjacent work — nearest neighbours from an arXiv sweep, for related-work only; none of them occupies the "app's own test suite → agent interface" cell. UIFormer (synthesizes DSL programs compressing UI representations, −48.7~55.8% tokens; frames the lack of Boolean oracles as the fundamental obstacle — but optimizes the observation, not the action contract) · TDAD (compiles agent prompts from behavioural specs turned into executable tests; the reusable part is its anti-specification-gaming protocol) · SkillFab (demand-first skill lifecycle: unmet capability → skill → review → registry) · MACdroid (abstracts general test logic from source tests and re-concretizes it — exactly the lift needed, but the output is another test) · ReuseDroid · NL2Test (carves replayable API regression tests from captured traffic; 3,196 tests in production, 85.4% adoption) · TestGen at Meta · "Modern web test suites rot" (counter-evidence to stay honest: UI refactors break locators and teams abandon suites within weeks) · CLI task-synthesis cluster — CLI-Universe, SETA, Terminal-World (keyword-adjacent but orthogonal: they synthesize tasks and environments for training, not interfaces for acting).