Skip to content
Back to search

liveog

Link previews that stay current. Open source, zero dependencies, with an MCP server.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bilal-abraham/liveog with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bilal-abraham/liveog'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bilal-abraham--liveog/badge.svg)](/listings/bilal-abraham--liveog)

HTML

<a href="/listings/bilal-abraham--liveog"><img src="/api/listings/bilal-abraham--liveog/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Let your agent do it

npx liveog mcp add

This finds the agent apps on your machine and adds the liveog MCP server to each one: Hermes Agent, Claude Code, Codex, Cursor, VS Code, Amp, Windsurf (Devin Desktop), Claude Desktop, OpenCode, Kiro and LM Studio. Antigravity, Zed, JetBrains, Cline, Warp, Goose, Continue and Kilo Code work too, with one step by hand (see below). Restart the app, then ask:

> Set up link previews for this project.

The agent studies your project (colours, fonts, logo, routes), asks you which links matter, draws two or three cover ideas for you to pick from, wires in the code, and checks the result.

Or do it yourself

npm i liveog
import { links, originOf } from 'liveog';

// 1. Say what kinds of link you have. First match wins; the last argument is the fallback.
const site = links('yoursite', [
  { name: 'invite', match: (p) => p.startsWith('/join/'), private: true,
    title: 'Join the team', description: 'On yoursite.', cover: '/og/invite.png' },
], { name: 'home', title: 'yoursite', description: 'What it does.', cover: '/og/home.png' });

// 2. Wherever your server sends an HTML page:
const origin = originOf(req.headers.host, process.env.SITE);   // SITE = your public domain
for (const [k, v] of Object.entries(site.headers(path))) res.setHeader(k, v);
res.end(site.page(html, path, origin));

Then draw the covers once and commit them:

npx liveog cover "yoursite" public/og/home.png     # the built-in cover, black and white
npx liveog draw cover.html public/og/home.png      # or your own 1200 x 630 HTML page
npx liveog check https://yoursite.com/             # see what a chat app will show

Static site? Call `tags(card)` at build time and paste the result into each page's `<head>`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 138 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset=".github/logo-dark.svg">
  4. <img src=".github/logo-light.svg" alt="liveog" width="177" height="40">
  5. </picture>
  6. </p>
  7. <p align="center">
  8. Link previews that stay current.<br>
  9. <a href="https://bilal-abraham.github.io/liveog/">Website</a> · <a href="https://www.npmjs.com/package/liveog">npm</a> · MIT
  10. </p>
  11. ---
  12. When someone pastes your link into iMessage, Slack, X or WhatsApp, the app shows a preview card.
  13. liveog makes that card show **what is true right now**: who is going, the current bid, how close
  14. the fundraiser is. And it does it without an image server.
  15. - **Covers drawn in a browser**: your Chrome at build time, or your user's open page at run time.
  16. Your server only stores a PNG.
  17. - **Always fresh**: every new picture gets a new address, so a link shared again never shows a
  18. stale, cached image.
  19. - **Private links stay private**: invite codes and share tokens never show in a preview, and those
  20. pages stay out of search engines and caches.
  21. - **Zero dependencies**, ESM. Works on Node 22+, Deno, Bun, Cloudflare Workers and Vercel.
  22. ## Quick start
  23. ### Let your agent do it
  24. ```sh
  25. npx liveog mcp add
  26. ```
  27. This finds the agent apps on your machine and adds the liveog MCP server to each one: Hermes
  28. Agent, Claude Code, Codex, Cursor, VS Code, Amp, Windsurf (Devin Desktop), Claude Desktop, OpenCode,
  29. Kiro and LM Studio. Antigravity, Zed, JetBrains, Cline, Warp, Goose, Continue and Kilo Code work
  30. too, with one step by hand (see below). Restart the app, then ask:
  31. > Set up link previews for this project.
  32. The agent studies your project (colours, fonts, logo, routes), asks you which links matter, draws
  33. two or three cover ideas for you to pick from, wires in the code, and checks the result.
  34. ### Or do it yourself
  35. ```sh
  36. npm i liveog
  37. ```
  38. ```js
  39. import { links, originOf } from 'liveog';
  40. // 1. Say what kinds of link you have. First match wins; the last argument is the fallback.
  41. const site = links('yoursite', [
  42. { name: 'invite', match: (p) => p.startsWith('/join/'), private: true,
  43. title: 'Join the team', description: 'On yoursite.', cover: '/og/invite.png' },
  44. ], { name: 'home', title: 'yoursite', description: 'What it does.', cover: '/og/home.png' });
  45. // 2. Wherever your server sends an HTML page:
  46. const origin = originOf(req.headers.host, process.env.SITE); // SITE = your public domain
  47. for (const [k, v] of Object.entries(site.headers(path))) res.setHeader(k, v);
  48. res.end(site.page(html, path, origin));
  49. ```
  50. Then draw the covers once and commit them:
  51. ```sh
  52. npx liveog cover "yoursite" public/og/home.png # the built-in cover, black and white
  53. npx liveog draw cover.html public/og/home.png # or your own 1200 x 630 HTML page
  54. npx liveog check https://yoursite.com/ # see what a chat app will show
  55. ```
  56. Static site? Call `tags(card)` at build time and paste the result into each page's `<head>`.
  57. ## Covers that change
  58. For links whose picture should change (an invite filling up, a price, a bid), the page that has
  59. the thing open draws the cover and sends it to your server:
  60. ```js
  61. // In the browser
  62. import { drawCover, sendCover } from 'liveog/browser';
  63. const png = await drawCover((ctx, w, h) => { /* draw on a 1200 x 630 canvas */ });
  64. await sendCover('/api/invites/42/cover', png);
  65. ```
  66. ```js
  67. // On your server
  68. import { isCover, nextCover, coverPath, parseCoverPath, answer } from 'liveog';
  69. if (!isCover(bytes)) return reply(400); // must be a 1200 x 630 PNG under 300 KB
  70. invite.cover = nextCover(invite.cover); // same id, version + 1
  71. save(bytes); // the link's preview image is coverPath(invite.cover)
  72. // GET /c/<id>/<version>.png
  73. const a = answer(parseCoverPath(path), invite.cover); // 200, a 302 to the newest, or 404
  74. ```
  75. If a private link is stopped or replaced, call `nextCover(cover, true)`: it makes a new id, and the
  76. old picture's address stops working.
  77. There is always a fallback: until a link has its own cover, it shows its kind's generic one.
  78. ## Any other MCP client
  79. liveog's MCP server speaks the standard protocol over stdin/stdout. Point your client at:
  80. ```json
  81. { "mcpServers": { "liveog": { "command": "npx", "args": ["-y", "liveog", "mcp"] } } }
  82. ```
  83. Its tools:
  84. | Tool | What it does |
  85. |---|---|
  86. | `study_project` | reads your project's colours, fonts, logo files, routes and existing previews |
  87. | `draw_cover` | draws a 1200 x 630 cover and shows it to the agent |
  88. | `setup_project` | the code to wire liveog into your server |
  89. | `check_link` | fetches a live link the way a chat app does and reports what's wrong |
  90. ## API
  91. | Import | |
  92. |---|---|
  93. | `tags(card)`, `inject(html, tags)` | the meta tags, and putting them before `</head>` |
  94. | `links(site, kinds, fallback)` | `.page()`, `.headers()`, `.card()` and `.of()` for a path |
  95. | `originOf(host, site?)`, `cleanHost(x)` | a safe absolute origin for image addresses |
  96. | `coverHtml(words, look?)` | the built-in cover as HTML (site, tag, title, line, picture) |
  97. | `isCover`, `imageSize` | checks a PNG's size without decoding it |
  98. | `nextCover`, `coverPath`, `parseCoverPath`, `answer` | versioned cover addresses |
  99. | `check`, `describe`, `readTags` | the link checker |
  100. | `liveog/draw` | `draw(page, out)` with your local Chrome (Node only) |
  101. | `liveog/browser` | `drawCover`, `sendCover` for the user's page |
  102. ## License
  103. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.