benjitaylor/agentation

benjitaylor/agentation has 5,339 GitHub stars and 429 forks. GitHot measured +32 stars in 24 hours. Last checked 2026-11-08 12:53 UTC. Last push 2026-09-22.

Cómo se miden estas cifras

The visual feedback tool for agents.

5,339 estrellas 429 forks +32 in 24h

What you can do

Click to annotate – Click any element with automatic selector identification
Text selection – Select text to annotate specific content
Multi-select – Hold Cmd/Ctrl to select elements individually, or drag to select multiple at once
Area selection – Drag to annotate any region, even empty space

Crecimiento de estrellas medido

in 24h: +32
in 7 days: Recopilando historial
in 15 days: Recopilando historial
in 1 month: Recopilando historial

Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.

README.md

Original

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

Click to annotate – Click any element with automatic selector identification
Text selection – Select text to annotate specific content
Multi-select – Hold Cmd/Ctrl to select elements individually, or drag to select multiple at once
Area selection – Drag to annotate any region, even empty space
Animation pause – Pause supported CSS animations, Web Animations, and videos to capture specific states
Structured output – Copy markdown with selectors, positions, and context
Embedded pages – Select elements in open shadow roots and same-origin iframes
Integration options – Capture identifying attributes, choose metadata-only Copy formats, and open detected source locations through your editor integration
Hash routes – Opt in to separate annotations and sessions for each hash route
Dark/light mode – Toggle in settings, persists to localStorage
Zero dependencies – No runtime libraries beyond the React peer dependencies

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

React 18+
Desktop browser (mobile not supported)

Docs

Full documentation at agentation.com

License

Licensed under PolyForm Shield 1.0.0