Plain HTML

A folder of HTML, a Rails or Laravel app, a Python server, a static site generator quello has never heard of. The CLI covers all of it, in two modes.

Install

pnpm add -D quello-cli

Mode 1 — quello serves your files

For a project with no server of its own:

npx quello-cli . --serve --port 5181

It serves the folder as static files and answers the picks endpoint, so there is one process and one origin.

<script defer src="/__quello/client.js"></script>

Mode 2 — beside your own server

For a project already running on its own port:

npx quello-cli

It answers only the endpoint, on 5100, cross-origin. Point the tag at it:

<script defer src="http://127.0.0.1:5100/__quello/client.js"
        data-quello-endpoint="http://127.0.0.1:5100/__quello/picks"></script>

The CLI prints this tag on startup, filled in with whatever port and options you gave it.

Options

npx quello-cli --help

See the CLI reference for the full list.

What a pick will know

Selector, DOM path, text, attributes, computed style and rect — everything except a component name, because there is no framework runtime to ask.

In practice that is enough: #counter, the text Clicked 0 times and the DOM path locate an element in a codebase quickly, and your note tells the agent what to do with it.