MCPcopy
hub / github.com/benjitaylor/agentation

github.com/benjitaylor/agentation @main sqlite

repository ↗ · DeepWiki ↗
653 symbols 1,222 edges 84 files 64 documented · 10%
README

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.

Features

  • Click to annotate – Click any element with automatic selector identification
  • Text selection – Select text to annotate specific content
  • Multi-select – Drag to select multiple elements at once
  • Area selection – Drag to annotate any region, even empty space
  • Animation pause – Freeze all animations (CSS, JS, videos) to capture specific states
  • Structured output – Copy markdown with selectors, positions, and context
  • Dark/light mode – Matches your preference or set manually
  • Zero dependencies – Pure CSS animations, no runtime libraries

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

© 2026 Benji Taylor

Licensed under PolyForm Shield 1.0.0

Extension points exported contracts — how you extend this code

ReactFiber (Interface)
* React Fiber node type (minimal subset we care about) * Based on React internal structure
package/src/utils/react-detection.ts
BlogPost (Interface)
(no doc)
package/example/src/app/blog/page.tsx
AFSStore (Interface)
(no doc)
mcp/src/types.ts
ResolvedConfig (Interface)
* Resolved configuration with all defaults applied
package/src/utils/react-detection.ts
Feature (Interface)
(no doc)
package/example/src/app/components/FeaturesDemo.tsx
TenantStore (Interface)
(no doc)
mcp/src/server/sqlite.ts
ReactFiber (Interface)
* React Fiber node structure (partial, for type safety) * Based on React's internal FiberNode type
package/src/utils/source-location.ts
ChatMessage (Interface)
(no doc)
package/example/src/app/components/FeaturesDemo.tsx

Core symbols most depended-on inside this repo

delay
called by 119
package/example/src/app/components/FeaturesDemo.tsx
delay
called by 45
package/example/src/app/components/HeroDemo.tsx
getReactComponentName
called by 21
package/src/utils/react-detection.ts
runAnimation
called by 20
package/example/src/app/components/FeaturesDemo.tsx
sendError
called by 20
mcp/src/server/http.ts
getTenantStore
called by 17
mcp/src/server/tenant-store.ts
hideTooltipsUntilMouseLeave
called by 16
package/src/components/page-toolbar-css/index.tsx
getStore
called by 16
mcp/src/server/store.ts

Shape

Function 574
Method 43
Interface 30
Class 6

Languages

TypeScript100%

Modules by API surface

package/src/components/design-mode/skeletons.tsx70 symbols
mcp/src/server/sqlite.ts63 symbols
package/example/src/app/components/FeaturesDemo.tsx43 symbols
package/src/components/icons.tsx36 symbols
package/src/components/page-toolbar-css/index.tsx30 symbols
mcp/src/server/http.ts29 symbols
package/src/utils/storage.ts23 symbols
mcp/src/server/tenant-store.ts23 symbols
package/src/utils/source-location.ts22 symbols
mcp/src/server/store.ts21 symbols
package/src/utils/source-location.test.ts20 symbols
package/src/utils/react-detection.ts19 symbols

Dependencies from manifests, versioned

@modelcontextprotocol/sdk1.0.0 · 1×
@testing-library/react16.0.0 · 1×
@types/node20.0.0 · 1×
@types/react18.2.0 · 1×
@types/react-dom18.2.0 · 1×
@vitejs/plugin-react4.3.0 · 1×
agentationworkspace:* · 1×
beautiful-mermaid0.1.2 · 1×
better-sqlite312.6.2 · 1×
esbuild-sass-plugin3.6.0 · 1×
framer-motion12.28.1 · 1×

For agents

$ claude mcp add agentation \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact