Give AI agents real-time visual feedback

AI agents that can only read text output are flying blind. They execute a command but can't see what happened on screen. Agent Vision closes this loop: capture a screenshot, analyze the visual state, decide what to do, act, then capture again to verify. This scan-act-rescan cycle gives AI agents the same visual feedback humans rely on.

Without Agent Vision

Your AI agent runs a command and gets text output — maybe an exit code, maybe some logs. But it can't see the actual result on screen. Did the button change color? Did the dialog appear? Did the layout shift? The agent is guessing. It can't course-correct because it can't observe the effect of its own actions.

With Agent Vision

After every action, the agent re-captures the screen. It can compare before and after screenshots, verify that expected elements appeared or disappeared, detect error states visually, and decide its next action based on what it actually sees. The feedback loop is tight: act, observe, adjust. Just like a human.

Commands

How it works

Capture baseline state

terminal
$ agent-vision capture --session $SID --tag before

Take a screenshot before acting. The tag helps your agent track which capture is which.

Perform an action

terminal
$ agent-vision click --element el-btn-001 --session $SID

Click, type, scroll — whatever the next step requires.

Re-capture after the action

terminal
$ agent-vision capture --session $SID --tag after

Screenshot the result. Your agent compares this with the baseline to verify the change.

Discover new elements that appeared

terminal
$ agent-vision elements --session $SID

After a UI change, new elements may appear (modals, error messages, new screens). Discover them.

Loop until the goal is reached

terminal
$ agent-vision capture --session $SID --tag step-3

Each iteration brings the agent closer to its goal. The visual feedback tells it when to stop.

Real scenario

Example: AI agent debugging a UI layout issue

workflow
01
Agent captures the current app state and notices a button is overlapping a text field
02
Agent modifies the CSS in the editor (via its coding tools)
03
Agent re-captures the app to see if the overlap is fixed
04
The overlap persists — agent adjusts the margin value and saves again
05
Agent captures once more and confirms the layout is correct
06
Agent moves on to the next visual issue, repeating the cycle

Try it now

$ brew tap rvanbaalen/agent-vision
$ brew install agent-vision

Requires macOS 13+ · No dependencies · ~4MB

← Back to agentvision.robinvanbaalen.nl