Skip to content
Back to search

agentation

The visual feedback tool for agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/benjitaylor--agentation/badge.svg)](/listings/benjitaylor--agentation)

HTML

<a href="/listings/benjitaylor--agentation"><img src="/api/listings/benjitaylor--agentation/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install agentation -D

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 82 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <picture>
  2. <source media="(prefers-color-scheme: dark)" srcset="package/logo-dark.svg">
  3. <img src="package/logo.svg" alt="Agentation" width="180">
  4. </picture>
  5. <br>
  6. [![npm version](https://img.shields.io/npm/v/agentation)](https://www.npmjs.com/package/agentation)
  7. [![downloads](https://img.shields.io/npm/dm/agentation)](https://www.npmjs.com/package/agentation)
  8. **[Agentation](https://agentation.com)** 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.
  9. ## Install
  10. ```bash
  11. npm install agentation -D
  12. ```
  13. ## Usage
  14. ```tsx
  15. import { Agentation } from 'agentation';
  16. function App() {
  17. return (
  18. <>
  19. <YourApp />
  20. <Agentation />
  21. </>
  22. );
  23. }
  24. ```
  25. The toolbar appears in the bottom-right corner. Click to activate, then click any element to annotate it.
  26. ## Connect to your agent
  27. Copied feedback works with Claude Code, Codex, Gemini, Grok, or any AI tool.
  28. For direct sync, register `npx -y agentation-mcp server` with your MCP client and
  29. connect the toolbar to its HTTP endpoint:
  30. ```tsx
  31. <Agentation endpoint="http://localhost:4747" />
  32. ```
  33. Keep the agent running, add a test annotation, and ask it to read the feedback.
  34. See the [setup guide](https://agentation.com/install#agent-integration).
  35. ## Features
  36. - **Click to annotate** – Click any element with automatic selector identification
  37. - **Text selection** – Select text to annotate specific content
  38. - **Multi-select** – Hold Cmd/Ctrl to select elements individually, or drag to select multiple at once
  39. - **Area selection** – Drag to annotate any region, even empty space
  40. - **Animation pause** – Pause supported CSS animations, Web Animations, and videos to capture specific states
  41. - **Structured output** – Copy markdown with selectors, positions, and context
  42. - **Embedded pages** – Select elements in open shadow roots and same-origin iframes
  43. - **Integration options** – Capture identifying attributes, choose metadata-only Copy formats, and open detected source locations through your editor integration
  44. - **Hash routes** – Opt in to separate annotations and sessions for each hash route
  45. - **Dark/light mode** – Toggle in settings, persists to localStorage
  46. - **Zero dependencies** – No runtime libraries beyond the React peer dependencies
  47. See the [package README](package/README.md) for props and integration examples.
  48. ## How it works
  49. 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.
  50. ## Requirements
  51. - React 18+
  52. - Desktop browser (mobile not supported)
  53. ## Docs
  54. Full documentation at [agentation.com](https://agentation.com)
  55. ## License
  56. © 2026 Benji Taylor
  57. Licensed under PolyForm Shield 1.0.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.