agentation README

The project's README from github.com/benjitaylor/agentation. As one markdown file: README.md.

Agentation

npm version downloads

Agentation is an agent-agnostic visual feedback tool. Click elements on your page, add notes, and copy structured output that helps AI coding agents find the exact code you're referring to.

Install

npm install agentation -D

Usage

import { Agentation } from 'agentation';

function App() {
  return (
    <>
      <YourApp />
      <Agentation />
    </>
  );
}

The toolbar appears in the bottom-right corner. Click to activate, then click any element to annotate it.

Connect to your agent

Copied feedback works with Claude Code, Codex, Gemini, Grok, or any AI tool. For direct sync, register npx -y agentation-mcp server with your MCP client and connect the toolbar to its HTTP endpoint:

<Agentation endpoint="http://localhost:4747" />

Keep the agent running, add a test annotation, and ask it to read the feedback. See the setup guide.

Features

See the package README for props and integration examples.

How it works

Agentation captures class names, selectors, and element positions so AI agents can grep for the exact code you're referring to. Instead of describing "the blue button in the sidebar," you give the agent .sidebar > button.primary and your feedback.

Requirements

Docs

Full documentation at agentation.com

License

© 2026 Benji Taylor

Licensed under PolyForm Shield 1.0.0

agentation (benjitaylor/agentation)

Searching Database…

Что это такое?Agentation — это инструмент визуальной обратной связи для ИИ-агентов, которые пишут код: вы кликаете по элементам на своей веб-странице, добавляете заметки и копируете структурированный текст, который помогает агенту найти именно тот код, на который вы указываете.
Это расширение для браузера, которое я устанавливаю, или библиотека, которую я добавляю в своё приложение?Библиотека: npm-пакет, который вы добавляете в своё React-приложение; его тулбар отображается внутри вашей страницы в правом нижнем углу. Отдельного приложения или расширения устанавливать не нужно, а кроме peer-зависимости на React в рантайме он не тянет никаких других библиотек.
Как этим пользоваться, когда пакет уже добавлен в приложение?Кликните по тулбару в правом нижнем углу, чтобы его активировать, затем кликайте по любому элементу, чтобы оставить пометку — селекторы определяются автоматически. Скопируйте сгенерированный markdown и вставьте его в своего агента.
Что нужно проекту, чтобы всё работало?React 18+ в проекте и настольный браузер, в котором вы будете этим пользоваться, — больше ничего.
Можно пользоваться с телефона или планшета?Нет — нужен настольный браузер; мобильные устройства не поддерживаются, поэтому размечать страницы придётся там, где вы ведёте разработку.
Для кого это вообще — для разработчиков или дизайнеров?В первую очередь для разработчиков, которые работают с ИИ-агентами над веб-интерфейсами: всех, кто вместо того, чтобы показать агенту конкретный элемент, описывает его словами вроде «синяя кнопка в сайдбаре».
Это open source под разрешительной лицензией?Нет — проект распространяется под лицензией PolyForm Shield 1.0.0, а не MIT или Apache, так что перед тем как переиспользовать код в своём продукте, ознакомьтесь с условиями.
Каким ИИ-агентам можно передать этот фидбек?Любому. Скопированный markdown — это обычный структурированный текст, поэтому он работает с Claude Code, Codex, Gemini, Grok или любым другим ИИ-инструментом, куда вы его вставите. Чтобы передавать результат автоматически, без копипаста, зарегистрируйте сервер agentation-mcp в своём MCP-клиенте и подключите тулбар к его HTTP-эндпоинту.
Как агент находит точный код по моей пометке?В скопированном markdown есть CSS-селекторы, имена классов, положение элементов и контекст, поэтому агент может найти нужный элемент в кодовой базе через grep, а не угадывать по словесному описанию. Есть и интеграция с редактором, которая может сразу открыть найденные места в исходниках.
Что ещё можно размечать, кроме клика по одному элементу?Довольно многое: выделять текст, зажать Cmd/Ctrl и выбирать элементы по одному, выделить сразу несколько перетаскиванием или растянуть область на пустом месте. Также можно поставить на паузу CSS-анимации, Web Animations и видео, чтобы зафиксировать нужное состояние перед разметкой.
Работает ли это внутри shadow DOM и iframe?Да — можно выбирать элементы внутри открытых shadow root и iframe с того же домена. В настройках можно включить поддержку hash-маршрутов, чтобы у каждого маршрута были свои пометки и сессии, а также переключить тёмную или светлую тему.
Size
6.4 MB
Stars
5K
Age
9mo
Commits · 90 Days