@lowdep/log-tail 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rushabh Shah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# log-tail
+
+![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen) ![Node](https://img.shields.io/badge/node-%3E%3D14-blue) ![License: MIT](https://img.shields.io/badge/license-MIT-green) ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+
+
+Cross-platform `tail -f` replacement with regex filtering, JSON log parsing, level-based colorization, and multi-file watching. Zero dependencies.
+
+Windows has no `tail -f`. PowerShell's `Get-Content -Wait` is clunky and doesn't filter. `log-tail` runs anywhere Node.js does.
+
+---
+
+## Install
+
+```bash
+npm install -g log-tail
+```
+
+Or without installing:
+
+```bash
+npx log-tail server.log
+```
+
+---
+
+## Usage
+
+```bash
+log-tail server.log                        # tail -f equivalent
+log-tail app.log error.log                 # Multiple files, labeled output
+log-tail server.log --grep "ERROR|WARN"    # Filter lines
+log-tail access.log --highlight "404"      # Highlight matches in red
+log-tail app.json --json                   # Pretty-print JSON log lines
+log-tail server.log -n 100 --no-follow     # Like `tail -100`, no follow
+log-tail server.log --exclude "/health"    # Skip noisy lines
+```
+
+---
+
+## Auto-Colorization
+
+Lines containing standard log levels are colored automatically:
+
+| Pattern | Color |
+|---|---|
+| `ERROR`, `FATAL`, `CRITICAL` | red |
+| `WARN`, `WARNING` | yellow |
+| `INFO`, `NOTICE` | cyan |
+| `DEBUG`, `TRACE` | dim |
+
+HTTP status codes (`4xx`, `5xx`, etc.) are also highlighted.
+
+Disable with `--no-color`.
+
+---
+
+## JSON Log Mode
+
+Given lines like:
+```json
+{"level":"error","msg":"DB query timed out","timestamp":"2024-08-01T12:00:00Z","duration_ms":4012}
+```
+
+Run `log-tail app.log --json`:
+```
+2024-08-01T12:00:00Z ERROR DB query timed out  duration_ms=4012
+```
+
+Recognized fields:
+- Message: `message`, `msg`, `text`
+- Level: `level`, `severity`, `lvl`
+- Timestamp: `timestamp`, `time`, `ts`
+
+All other fields are shown as `key=value` extras.
+
+---
+
+## Multi-File
+
+When watching multiple files, each line is labeled with the filename in its own color:
+
+```
+server.log │ GET /api/users 200 12ms
+worker.log │ Processing job #12345
+server.log │ POST /api/login 401 4ms
+```
+
+---
+
+## Options
+
+| Flag | Default | Description |
+|---|---|---|
+| `-n, --lines <N>` | `10` | Show last N lines before following |
+| `--follow / --no-follow` | follow | Keep watching for new lines |
+| `--grep <pattern>` | — | Only show lines matching regex |
+| `--exclude <pattern>` | — | Skip lines matching regex |
+| `--highlight <pattern>` | — | Highlight matches in bold red |
+| `--interval <ms>` | `250` | Poll interval |
+| `--json` | off | Pretty-print JSON log lines |
+| `--no-color` | off | Disable colorization |
+
+---
+
+## License
+
+MIT
+
+---
+
+## Keywords
+
+`tail -f windows` · `tail follow` · `log viewer` · `follow logs` · `tail logs` · `log tail` · `live logs` · `json logs` · `cross-platform` · `zero dependencies`
+
+---
+
+<div align="center">
+
+**Built to solve, shared to help — Rushabh Shah 🛠️✨**
+
+<sub>One of 40+ zero-dependency developer CLI tools — no <code>node_modules</code>, ever.</sub>
+
+</div>

package/bin/log-tail.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+const VERSION = '1.0.0';
+
+// ─── ANSI ─────────────────────────────────────────────────────────────────────
+const isTTY  = process.stdout.isTTY;
+const c      = (code, t) => isTTY ? `\x1b[${code}m${t}\x1b[0m` : t;
+const bold   = t => c('1',  t);
+const dim    = t => c('2',  t);
+const red    = t => c('31', t);
+const green  = t => c('32', t);
+const yellow = t => c('33', t);
+const cyan   = t => c('36', t);
+const blue   = t => c('34', t);
+const magenta = t => c('35', t);
+
+const FILE_COLORS = [cyan, magenta, yellow, blue, green];
+
+// ─── Log line colorization (level detection) ──────────────────────────────────
+const LEVEL_PATTERNS = [
+  { re: /\b(ERROR|FATAL|CRITICAL|EMERG)\b/i,  color: red },
+  { re: /\b(WARN|WARNING)\b/i,                color: yellow },
+  { re: /\b(INFO|NOTICE)\b/i,                 color: cyan },
+  { re: /\b(DEBUG|TRACE)\b/i,                 color: dim },
+];
+
+function colorizeLine(line, colorize) {
+  if (!colorize) return line;
+  for (const { re, color } of LEVEL_PATTERNS) {
+    if (re.test(line)) {
+      return color(line);
+    }
+  }
+  // Highlight HTTP status codes
+  return line.replace(/\b([45]\d\d)\b/g, m => red(m))
+             .replace(/\b(3\d\d)\b/g,   m => yellow(m))
+             .replace(/\b(2\d\d)\b/g,   m => green(m));
+}
+
+// ─── JSON line pretty-printer ─────────────────────────────────────────────────
+function tryParseJson(line) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith('{') || !trimmed.endsWith('}')) return null;
+  try { return JSON.parse(trimmed); } catch { return null; }
+}
+
+function formatJsonLine(obj) {
+  const level   = obj.level || obj.severity || obj.lvl || '';
+  const msg     = obj.message || obj.msg || obj.text || '';
+  const ts      = obj.timestamp || obj.time || obj.ts || '';
+  const levelUp = String(level).toUpperCase();
+
+  let levelColored = levelUp;
+  if (/ERROR|FATAL/.test(levelUp))   levelColored = red(levelUp.padEnd(5));
+  else if (/WARN/.test(levelUp))     levelColored = yellow(levelUp.padEnd(5));
+  else if (/INFO/.test(levelUp))     levelColored = cyan(levelUp.padEnd(5));
+  else if (/DEBUG/.test(levelUp))    levelColored = dim(levelUp.padEnd(5));
+  else if (levelUp)                  levelColored = levelUp.padEnd(5);
+
+  const extras = Object.entries(obj)
+    .filter(([k]) => !['level', 'severity', 'lvl', 'message', 'msg', 'text', 'timestamp', 'time', 'ts'].includes(k))
+    .map(([k, v]) => `${dim(k)}=${typeof v === 'object' ? JSON.stringify(v) : v}`)
+    .join(' ');
+
+  return `${dim(ts)} ${levelColored} ${msg}  ${dim(extras)}`.trim();
+}
+
+// ─── Tail one file ────────────────────────────────────────────────────────────
+function tailFile(filePath, opts, onLine, fileLabel) {
+  const { lines, follow, pollInterval } = opts;
+
+  let position = 0;
+  let leftover = '';
+
+  // Read last N lines from end
+  if (lines > 0 && fs.existsSync(filePath)) {
+    const stat = fs.statSync(filePath);
+    const size = stat.size;
+    const chunkSize = Math.min(size, 64 * 1024 * Math.max(1, Math.ceil(lines / 100)));
+    if (chunkSize > 0) {
+      const fd  = fs.openSync(filePath, 'r');
+      const buf = Buffer.alloc(chunkSize);
+      fs.readSync(fd, buf, 0, chunkSize, Math.max(0, size - chunkSize));
+      fs.closeSync(fd);
+      const text     = buf.toString('utf8');
+      const lineArr  = text.split(/\r?\n/);
+      // Drop trailing empty string if file ended with newline
+      if (lineArr.length && lineArr[lineArr.length - 1] === '') lineArr.pop();
+      // Drop first entry if our read window started mid-line
+      if (chunkSize < size && lineArr.length) lineArr.shift();
+      const lastN    = lineArr.slice(-lines);
+      for (const line of lastN) if (line) onLine(line, fileLabel);
+    }
+    position = size;
+  }
+
+  if (!follow) return null;
+
+  // Poll for changes (simpler & more reliable than fs.watch across platforms)
+  return setInterval(() => {
+    try {
+      const stat = fs.statSync(filePath);
+      if (stat.size < position) {
+        // Truncated/rotated — reset
+        position = 0;
+        leftover = '';
+      }
+      if (stat.size > position) {
+        const fd     = fs.openSync(filePath, 'r');
+        const length = stat.size - position;
+        const buf    = Buffer.alloc(length);
+        fs.readSync(fd, buf, 0, length, position);
+        fs.closeSync(fd);
+        position += length;
+        const chunk = leftover + buf.toString('utf8');
+        const parts = chunk.split(/\r?\n/);
+        leftover = parts.pop();
+        for (const line of parts) if (line) onLine(line, fileLabel);
+      }
+    } catch { /* file may be temporarily unavailable */ }
+  }, pollInterval);
+}
+
+// ─── CLI ──────────────────────────────────────────────────────────────────────
+const args       = process.argv.slice(2);
+const VALUE_FLAGS = new Set(['--lines', '-n', '--grep', '--exclude', '--interval', '--highlight']);
+
+function getFlag(...names) {
+  for (const f of names) {
+    const i = args.indexOf(f);
+    if (i !== -1) return args[i + 1];
+  }
+  return null;
+}
+function hasFlag(...names) { return names.some(f => args.includes(f)); }
+
+const positional = [];
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith('-')) {
+    if (VALUE_FLAGS.has(args[i])) i++;
+  } else positional.push(args[i]);
+}
+
+if (hasFlag('--version', '-v')) {
+  console.log(`log-tail v${VERSION}`); process.exit(0);
+}
+
+if (hasFlag('--help', '-h') || !positional.length) {
+  console.log(`
+${bold('log-tail')} — Cross-platform tail -f replacement with regex filtering
+
+${bold('USAGE')}
+  log-tail <file...> [options]
+
+${bold('OPTIONS')}
+  -n, --lines <N>      Show last N lines before following (default: 10)
+  -f, --follow         Keep watching for new lines (default: on for single TTY)
+  --no-follow          Print last N lines and exit
+  --grep <pattern>     Only show lines matching regex
+  --exclude <pattern>  Skip lines matching regex
+  --highlight <pat>    Highlight matches in bold red
+  --interval <ms>      Poll interval (default: 250)
+  --no-color           Disable level/status colorization
+  --json               Pretty-print JSON log lines (level, msg, extras)
+  --version            Show version
+
+${bold('EXAMPLES')}
+  log-tail server.log                       # tail -f equivalent
+  log-tail app.log error.log                # Multiple files, labeled output
+  log-tail server.log --grep "ERROR|WARN"   # Filter
+  log-tail access.log --highlight "404"     # Highlight 404s
+  log-tail app.json --json                  # Pretty-print JSON logs
+  log-tail server.log -n 100 --no-follow    # Like tail -100
+`);
+  process.exit(positional.length ? 0 : 1);
+}
+
+const files       = positional.map(p => path.resolve(p));
+const numLines    = parseInt(getFlag('--lines', '-n') || '10', 10);
+const noFollow    = hasFlag('--no-follow');
+const follow      = !noFollow;
+const grepPattern = getFlag('--grep') ? new RegExp(getFlag('--grep')) : null;
+const excludePat  = getFlag('--exclude') ? new RegExp(getFlag('--exclude')) : null;
+const highlight   = getFlag('--highlight') ? new RegExp(getFlag('--highlight'), 'g') : null;
+const pollInterval= parseInt(getFlag('--interval') || '250', 10);
+const noColor     = hasFlag('--no-color');
+const jsonMode    = hasFlag('--json');
+
+for (const f of files) {
+  if (!fs.existsSync(f)) {
+    console.error(red(`\nFile not found: ${f}\n`)); process.exit(1);
+  }
+}
+
+const showLabel = files.length > 1;
+
+function emit(line, fileLabel) {
+  if (grepPattern && !grepPattern.test(line)) return;
+  if (excludePat  && excludePat.test(line))   return;
+
+  let out = line;
+
+  if (jsonMode) {
+    const obj = tryParseJson(line);
+    if (obj) out = formatJsonLine(obj);
+  }
+
+  if (!noColor) out = colorizeLine(out, true);
+
+  if (highlight) {
+    out = out.replace(highlight, m => bold(red(m)));
+  }
+
+  if (showLabel) {
+    process.stdout.write(`${fileLabel} ${dim('│')} ${out}\n`);
+  } else {
+    process.stdout.write(out + '\n');
+  }
+}
+
+console.log();
+const intervals = [];
+files.forEach((f, i) => {
+  const label = showLabel ? FILE_COLORS[i % FILE_COLORS.length](path.basename(f)) : '';
+  const iv = tailFile(f, { lines: numLines, follow, pollInterval }, emit, label);
+  if (iv) intervals.push(iv);
+});
+
+if (follow) {
+  process.on('SIGINT', () => {
+    intervals.forEach(clearInterval);
+    console.log(dim('\n  Stopped.\n'));
+    process.exit(0);
+  });
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@lowdep/log-tail",
+  "version": "1.0.0",
+  "description": "Cross-platform tail -f with regex filtering, multi-file, JSON pretty-print, and color — zero dependencies",
+  "bin": {
+    "log-tail": "bin/log-tail.js"
+  },
+  "keywords": [
+    "tail",
+    "log",
+    "logs",
+    "cli",
+    "follow",
+    "filter",
+    "developer-tools",
+    "cross-platform",
+    "zero-dependencies",
+    "tail -f windows",
+    "tail follow",
+    "log viewer",
+    "follow logs",
+    "tail logs",
+    "log tail",
+    "live logs",
+    "json logs",
+    "zero dependencies"
+  ],
+  "author": "Rushabh Shah",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "files": [
+    "bin/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rushabh5000/log-tail.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Rushabh5000/log-tail/issues"
+  },
+  "homepage": "https://github.com/Rushabh5000/log-tail#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}