kittyhtml 0.2.0 → 0.2.1

package/README.md

@@ -9,12 +9,16 @@ Built for AI agents that have something nice to show you — a styled report, a
 ## Install
 
 ```sh
-# from this directory, until published
-npm install
-npm link        # exposes the `kittyhtml` binary on your PATH
+npm install -g kittyhtml
 ```
 
-Requires Node 20+. Pulls in [`@napi-rs/canvas`](https://www.npmjs.com/package/@napi-rs/canvas) (prebuilt native binary, no compile step) and `dropflow`.
+Or one-shot, no install:
+
+```sh
+npx kittyhtml --demo
+```
+
+Requires Node 20+. Pulls in [`@napi-rs/canvas`](https://www.npmjs.com/package/@napi-rs/canvas) (prebuilt native binary, no compile step) and `dropflow`. Two deps total, ~90 KB tarball.
 
 ## Use
 
@@ -70,15 +74,15 @@ See the [DropFlow README](https://github.com/chearon/dropflow#supported-css-rule
 
 ## Fonts
 
-First run fetches Noto fonts from a CDN via DropFlow's bundled `register-noto-fonts.js`. Subsequent renders reuse what was loaded. Bundled offline fonts are on the roadmap.
+`Noto Sans` (regular, bold, italic, bold-italic) and `Noto Sans Mono` (regular, bold) ship inside the package as latin-subset TTFs (~160 KB total). No CDN fetch on first run; works offline. Reference them in HTML with `font-family: 'Noto Sans', sans-serif` and `font-family: 'Noto Sans Mono', monospace`.
 
 ## Claude Code skill
 
-A bundled skill lets Claude Code render output as a styled inline image when you ask for it as "kittyhtml" or "khtml":
+A bundled skill lets Claude Code render output as a styled inline image when you ask for it as "kittyhtml" or "khtml". After a global install:
 
 ```sh
 mkdir -p ~/.claude/skills
-cp -r skill/kittyhtml ~/.claude/skills/kittyhtml
+cp -r "$(npm root -g)/kittyhtml/skill/kittyhtml" ~/.claude/skills/
 ```
 
 Then in any Claude Code session: *"give me this report as kittyhtml"* — the agent will generate DropFlow-compatible HTML and pipe it through this CLI. The skill is narrow on purpose; it only triggers on those keywords.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kittyhtml",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Render HTML to an image and display it inline in Kitty/iTerm2-capable terminals. No browser — CSS layout via DropFlow.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -80,6 +80,17 @@ function loadDemoHtml() {
   return readFileSync(join(here, '..', 'examples', 'demo.html'), 'utf8');
 }
 
+// readFileSync(0) crashes with EAGAIN when stdin is in non-blocking mode and
+// the upstream process hasn't flushed yet (common with `claude -p ... | kittyhtml`).
+// Async iteration over process.stdin yields back to the event loop and waits
+// for data, so it handles any pipe pacing correctly.
+async function readStdin() {
+  process.stdin.setEncoding('utf8');
+  let buf = '';
+  for await (const chunk of process.stdin) buf += chunk;
+  return buf;
+}
+
 async function main() {
   const opts = parseArgs(process.argv.slice(2));
 
@@ -89,7 +100,7 @@ async function main() {
   } else if (opts.file) {
     html = readFileSync(opts.file, 'utf8');
   } else if (!process.stdin.isTTY) {
-    html = readFileSync(0, 'utf8');
+    html = await readStdin();
   } else {
     process.stdout.write(HELP);
     process.exit(1);