DOCUMENTATION

How to Use Twiq.

From installation to AI-ready Markdown in six seconds. Everything you need to know.

1

Introduction

Twiq is an AI-native Chrome extension that turns visual clicks into deep, structured Markdown context. Instead of describing bugs with vague words or screenshots, you point at the element, click, and Twiq extracts the exact DOM snapshot, CSS bounding box, React component name, source file and line number, viewport metadata, and live console errors — all compiled into a Markdown report ready to paste into Cursor, Claude Code, Copilot, or any AI coding agent.

2

Installation

Chrome Web Store

Installing Twiq takes under 10 seconds:

  1. 1Visit the Twiq listing on the Chrome Web Store
  2. 2Click "Add to Chrome"
  3. 3Confirm the permission prompt (activeTab, clipboardWrite, storage)
  4. 4The Twiq icon appears in your extensions bar — you're ready.
No setup required. No npm install, no MCP servers, no codebase modifications. Twiq works entirely in the browser with zero configuration.
3

Quick Start — Six Steps

From broken UI to AI-ready Markdown context in six seconds.

1
Activate

Press Alt+S to enter Inspect Mode. A status badge appears in the top-right corner confirming Twiq is active.

2
Target

Move your cursor over any element on the page. A blue dashed bounding box highlights the target. The element is now ready for inspection.

3
Annotate

Click the element. A modal appears where you can type your instruction, e.g. "Make this button rounded and blue" or "Fix the alignment on mobile".

4
Drop Marker

Confirm the marker. Twiq pins a numbered lime-green badge on the element. Repeat steps 2–4 for as many elements as you need to document.

5
Copy Context

Press Alt+C to compile all markers into a structured Markdown report. It's automatically copied to your clipboard.

6
Execute

Open Cursor, Claude Code, Copilot, or any AI agent. Paste the Markdown. The AI reads exact context and writes the fix — right the first time.

4

Features Deep Dive

Zero-setup & agent-ready

No npm install. No local MCP servers. No codebase modifications. Runs entirely in the browser. Just install and click.

Deep DOM forensics

Extracts outerHTML, bounding box coordinates, computed styles, and exact selector paths on every click.

React Fiber tracing

Hooks into Chrome Debugger Protocol to reverse-engineer minified React. Extracts real component names and source locations.

Live error sniffing

Silently buffers 60 seconds of console.error logs and unhandled Promise rejections. Auto-attaches to your report.

Responsive context

Auto-detects viewport (Mobile / Tablet / Desktop) so your AI writes accurate Tailwind md: and sm: media queries.

Customizable UI

Dark-mode glassmorphic interface. Four detail levels: Compact, Standard, Detailed, Forensic. Custom marker colors.

5

What Twiq Captures

Every click produces a rich data snapshot. Here is everything included in your report:

DOM snapshot
Full outerHTML of the element
Bounding box
x, y, width, height coordinates
Computed styles
All CSS properties and values
Selector path
Exact CSS selector to the element
Component name
React component hierarchy (e.g. Hero > CTAButton)
Source location
Exact file and line number (e.g. Hero.tsx:42:15)
Viewport
Mobile / Tablet / Desktop with dimensions
Console errors
Last 60s of errors auto-attached
6

Keyboard Shortcuts

No mouse acrobatics. No context menus. Every action has a shortcut.

Toggle Inspect Mode
Enter or exit Twiq's inspector
AltS
Copy Markdown
Compile all markers to clipboard
AltC
Clear Markers
Wipe all current markers and data
AltX
Hide / Show Markers
Toggle visual markers on screen
AltH
Close Modal
Exit modals and inspect mode
Esc
Combo Power
Alt+S → click → Alt+C → paste
7

Detail Levels

Control how much context Twiq includes in each report. Choose the right level for your workflow.

LEVEL 1
Compact

Minimal output. Selector path and component name only. Quick captures.

LEVEL 2
Standard

Adds bounding box, viewport info, and primary computed styles. Default.

LEVEL 3
Detailed

Full DOM snapshot, all computed styles, console errors, and component tree.

LEVEL 4
Forensic

Everything including React fiber tree, network logs, full CSS cascade, and accessibility tree.

8

Output Format

Twiq generates structured Markdown that every AI agent understands natively.

WHAT YOU PASTE
Exact selector path
Component name with hierarchy
Source file and line number
Your instruction text
Bounding box coordinates
DOM snapshot
Computed styles
Console errors auto-attached
twiq-context.md
Alt+C
# Twiq Context Report
 
## Marker 1: CTAButton
- Instruction: "Make this button rounded and blue"
- Component: `Hero > CTAButton`
- Source: `Hero.tsx:42:15`
- Viewport: Desktop (1920×1080)
- Selector: `body > div.hero > button.cta`
 
### Bounding Box
- x: 540, y: 432
- width: 180, height: 48
 
### DOM Snapshot
<button class="cta px-4 py-2 bg-black">
  Get Started
</button>
 
### Computed Styles
- background-color: rgb(0, 0, 0)
- border-radius: 0px
 
### Console Errors
// 14:31:52 — auto-attached
"500 (Internal Server Error) — POST /api/cta/impression"
9

Use Cases

1
DESIGN HANDOFF

Rapid UI/UX iteration

Designers and PMs click around staging, leave notes, and ship structured Markdown to devs. No more Figma comments lost in translation.

PM clicks "Make this CTA bigger" Dev gets exact selector
2
DEBUGGING

Debug broken API buttons

Click a "Submit" button that's silently failing. Twiq auto-attaches the hidden 500 network error from the console to your report.

POST /api/submit 500 ← auto-attached
3
RESPONSIVE

Fix mobile responsiveness

Open mobile view, click a misaligned card, tell AI to fix it. Twiq tags viewport as "Mobile" so AI edits the right Tailwind classes.

viewport: mobile AI edits sm:flex-row
4
LEGACY NAVIGATION

Legacy codebase navigation

Working on a massive React codebase? Click any element and Twiq tells you the exact .tsx file and line it lives in. No more Ctrl+Shift+F marathons.

Ctrl+Shift+F for 20 min Hero.tsx:42:15
10

Compatible AI Agents

Twiq's Markdown output works with every major AI coding agent. Paste and go.

Cursor
Claude Code
Copilot
Windsurf
Aider
Continue
11

Tips & Best Practices

Be specific in instructions

Instead of "fix this button", write "Make this button's border-radius 12px, add a hover scale effect, and change text color to white". The more specific your instruction, the better the AI output.

Test on multiple viewports

Toggle DevTools to mobile view, drop markers, then repeat on desktop. Twiq tags each marker with the correct viewport, so your AI knows which breakpoint to target.

Reproduce errors before capturing

Twiq buffers the last 60 seconds of console errors. Before dropping a marker, trigger the bug so the error log captures the issue. It will be auto-attached to your report.

Use markers for multi-element bugs

If a bug spans multiple elements (a broken form with a bad button and missing validation), drop separate markers on each and copy them all at once. The AI sees the full picture.

Adjust detail level for the task

Use Compact for quick CSS tweaks. Standard (default) for most bug fixes. Detailed for complex React issues. Forensic when you need the full picture including fiber tree and network logs.