Reference
CLI
npx quello-cli — for projects with no bundler to hook into.
Terminal
npx quello-cli [dir] [options]
Runs the picks endpoint so any project can use quello, with or without a bundler. Optionally serves the directory too.
Options
-s, --serve | also serve [dir] as static files, for a plain html/js/css project |
-p, --port <n> | port to listen on — default 5100 |
--host <host> | host to bind — default 127.0.0.1 |
--shortcut <s> | picker shortcut, e.g. "ctrl+shift+p" — default alt+q |
--agent-file <f> | agent instructions file — default AGENTS.md |
--no-agent-file | do not write one |
--no-gitignore | do not add the picks directory to .gitignore |
-h, --help | show help |
Output
quello http://127.0.0.1:5100
picks /path/to/project/.quello/picks.json
agent AGENTS.md
Add to your page in development:
<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 tag it prints already carries whatever options you passed, so it can be pasted as-is.
Two modes
Endpoint only — the default. Your app stays on its own dev server; quello just answers the picks endpoint, cross-origin.
--serve — quello serves the directory as well, so a folder of HTML files needs nothing else
running. Paths that try to escape the served directory are refused.
Routes
GET /__quello/client.js | the runtime bundle |
GET /__quello/picks | the current picks |
POST /__quello/picks | replace them |
DELETE /__quello/picks | clear them |
These are the same routes the plugins serve, so the runtime cannot tell which one it is talking to.