Point-and-Click Feedback Turns MDX Into Agent-Editable Targets

·https://github.com/benjitaylor/agentation
repotoolaireacttypescriptmdxagent-feedbackagent-loopscontent-workflow

Agentation's structured selectors could turn visual feedback on joelclaw MDX lessons and copy into exact agent edits instead of vague screenshots.

Agentation is a React overlay for giving feedback to AI coding agents without the usual “that thing over there” bullshit. You click an element, select text, drag a region, or pause animation, then copy structured markdown with selectors, positions, and surrounding context.

The clever bit is that feedback becomes an addressable artifact. A comment attached to .sidebar > button.primary is much more useful to an agent than a screenshot with vibes. That maps cleanly to MDX lessons, copy, and database-backed content because the note can point at the rendered thing while still giving the agent breadcrumbs back to code or content.

This smells useful for joelclaw review loops: Agentation as the lightweight front-end for collecting operator notes, then agent workers can turn those notes into exact edits. The constraints matter: it requires React 18+, desktop browsers only, and uses the PolyForm Shield 1.0.0 license, so we should check fit before baking it into anything public or commercial.

Key Ideas

  • Agentation captures selectors, class names, positions, and context so an AI coding agent can search for the exact thing being discussed.
  • The feedback workflow turns visual review into structured markdown, which is a better handoff format than screenshots, long prose, or “the blue button in the sidebar.”
  • Text selection and area selection make it relevant beyond UI chrome: MDX lessons, copy blocks, and rendered database content can become reviewable targets.
  • Animation pause is a nice touch for inspecting transient UI states, including CSS, JavaScript, and video-driven interactions.
  • The package is intentionally small: zero runtime dependencies, pure CSS animations, and a single <Agentation /> component.

Links

← All discoveries