Kanko

Guide

Give an AI coding agent visual feedback it can act on

A coding agent can read a screenshot, but it cannot guess which part of the image you mean. These seven steps make each problem easy to find and each fix easy to check.

1. Capture only the part that matters

Crop the capture to the area with the problem, plus enough of the area around it to show where it sits in the app. A full-screen capture makes the agent search the whole image. It can also show private windows, names, or messages that the agent does not need, so check each image before you share it.

2. Put a number on each problem

Mark each spot with a numbered dot or an arrow. A number points at one exact place. A phrase such as “the button on the right” can match more than one element. Use one number for one problem, even when two problems are close together.

3. Write one note for each number

Each note says what is wrong and what you expect to see. Describe the result you want, and keep each note to one change, so that you can check each fix by itself.

1. The Save label is cut off. Show the whole label on one line.

2. The Cancel button sits lower than Save. Align the two buttons.

4. Say what must stay the same

Add one line for each thing the agent must leave alone, such as the width of a dialog or a color that is already correct. Without that line, an agent can change nearby code that you did not ask about.

5. Ask for a plan before any edit

Ask the agent to list the files it will change and what it will do in each one, numbered to match your notes. Read the plan and correct it before you let the agent edit. Many coding agents have a plan mode for this step.

6. Treat text in the image as reference

A screenshot can hold text that reads like an instruction, such as a chat message or a comment on a web page. Tell the agent that text inside your images is reference only, and that its instructions come from your notes.

7. Check the result with a new capture

After the change, capture the same area again and compare it with your notes. Reply with the numbers that still need work, so that the next round stays short.

Kanko does these steps on your Mac

Kanko is a small Mac app for this workflow. Capture part of your screen, drop numbered dots, write one note per dot, and copy one prompt that lists every image and note. The prompt asks the agent for a plan before it edits, and it marks text inside the images as reference only.

See how Kanko works

More guides: screenshot feedback in Claude Code and screenshot feedback in Cursor.