kosal-link

CLI that scrapes JS-rendered landing pages locally with GitHub auth and usage tracking in Convex.

Install

npm install -g kosal-link
npx playwright install chromium

Usage

kosal-link login
kosal-link scrape https://example.com -o ./out
kosal-link detect https://example.com
kosal-link pick https://example.com --open
kosal-link whoami
kosal-link logout

Config

Token stored at ~/.config/kosal-link/config.json.

Environment overrides:

• KOSAL_LINK_CONVEX_URL — Convex deployment URL
• KOSAL_LINK_AUTH_URL — landing page auth URL (default http://localhost:3000/cli/auth)

Development

cd cli
npm install
npm run build
node bin/kosal-link.js scrape https://example.com

Component workflows

Detect likely sections on a page:

kosal-link detect https://example.com

Use --clean if you want a stricter shortlist with fewer generic wrapper blocks:

kosal-link detect https://example.com --clean

Pick multiple detected components and export them:

kosal-link pick https://example.com --open

Interactive picker controls:

• ↑/↓ move
• space toggle current item
• a toggle all
• enter confirm
• esc or q cancel

Export specific detected rows without the picker:

kosal-link pick https://example.com --choose 1,3,5 --mode live

Export every detected component:

kosal-link pick https://example.com --all --open

pick also supports --clean if you want the interactive/export flow to start from the stricter shortlist.

Export a rendered subtree by selector:

kosal-link component https://example.com --selector ".pricing-section" -o ./pricing-export

Component export writes:

• component.html — standalone rendered fragment with inline styles
• component.png — cropped screenshot of the selected node
• meta.json — selector, size, text sample, and captured assets
• assets/ — downloaded assets referenced by the exported subtree

Export a higher-fidelity replay that keeps the selected component inside the original page context:

kosal-link component-live https://example.com --selector ".pricing-section" -o ./pricing-live
kosal-link serve ./pricing-live

component-live writes:

• index.html — full scraped page
• component-live.html — isolated live replay entrypoint
• component-live.json — replay metadata

When pick is used, it exports one folder per picked component under ./<hostname>-picked/ by default.