Skip to content

Seechi-Yolo/selector

 
 

Repository files navigation

Selector

Point at any element. Tell your AI what to change.

Selector is a local-first Chrome MV3 extension that lets you visually select elements on any web page, add instructions, and copy a structured prompt for Claude Code, Codex, Cursor, or any AI coding assistant.

Install for development

npm install
npm run build

Then open chrome://extensions, enable Developer mode, choose Load unpacked, and select dist/.

Usage

Open any web page and click the Selector extension action. You can also use Alt+Shift+S.

Action What it does
Click Select an element
Shift + Click Add to selection
Drag Marquee select multiple elements
↑ / ↓ Navigate to parent / child element
← / → Navigate to previous / next sibling
✎ button Add per-element instruction
⌘/Ctrl + C Copy prompt to clipboard
⌘/Ctrl + Z Undo last selection change
Space Pause / resume selecting
Esc Clear selection

The copied prompt includes element metadata (tag, selector, text, React component info) plus any per-element instructions you added.

Example output

Page: /dashboard

1. .hero-title <h1>
   selector: body > main > section > h1
   source: src/components/Hero.tsx:12
   react: Layout › Hero
   text: "Welcome to the Dashboard"
   html: <h1 class="hero-title">Welcome to the Dashboard</h1>
   instruction: Make this red and larger

2. .sidebar <nav>
   selector: body > aside > nav
   text: "Home Settings Profile Logout"
   html: <nav class="sidebar">…
   instruction: Add an "Analytics" link after "Settings"

How it works

The extension injects a content script into the active tab after a user action. Everything runs client-side in the browser. No selected content, annotations, prompts, or page metadata are uploaded.

Development

git clone https://github.com/oil-oil/selector.git
cd selector
npm install
npm run build

License

MIT

About

Visual element picker bookmarklet — select elements, annotate instructions, copy prompt for AI

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 47.4%
  • TypeScript 36.7%
  • CSS 8.6%
  • JavaScript 3.7%
  • Makefile 3.6%