@meebs/meeb 1.0.0

package/index.js

@@ -0,0 +1,915 @@
+#!/usr/bin/env node
+
+const animals = require('./animals')
+const visible = Object.fromEntries(Object.entries(animals).filter(([, v]) => !v.hidden))
+const { rgb } = require('./color')
+const { addSay, addHat, addLabel, stripAnsi, flipArt, stretchArt, squishArt, stretchVArt, squishVArt, sideBySide } = require('./util')
+const { resolve: emojiResolve } = require('./emoji')
+const { getFortune } = require('./fortune')
+
+const args = process.argv.slice(2)
+const flags = {}
+const positional = []
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--say') {
+    const words = []
+    while (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+      words.push(args[++i])
+    }
+    if (words.length) flags.say = words.join(' ')
+  } else if (args[i] === '--gif') {
+    flags.gif = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : 'meeb.gif'
+  } else if (args[i] === '--png') {
+    flags.png = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : 'meeb.png'
+  } else if (args[i] === '--svg') {
+    flags.svg = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : 'meeb.svg'
+  } else if (args[i] === '--label') {
+    const words = []
+    while (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+      words.push(args[++i])
+    }
+    if (words.length) flags.label = words.join(' ')
+  } else if (args[i] === '--hat') {
+    flags.hat = true
+  } else if (args[i] === '--tiny') {
+    flags.tiny = true
+  } else if (args[i] === '--no-color') {
+    flags.noColor = true
+  } else if (args[i] === '--theme') {
+    flags.theme = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : true
+  } else if (args[i] === '--pair') {
+    flags.pair = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : true
+  } else if (args[i] === '--diff') {
+    flags.diff = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : true
+  } else if (args[i] === '--animate') {
+    flags.animate = (args[i + 1] && !args[i + 1].startsWith('--')) ? args[++i] : true
+  } else if (args[i].startsWith('--')) {
+    flags[args[i].slice(2)] = true
+  } else {
+    positional.push(args[i])
+  }
+}
+
+// Treat bare subcommand words in positional as flags
+// e.g. "meeb mouse say hi" => animal=mouse, flags.say="hi"
+const flagWords = {
+  say: 'say', says: 'say', saying: 'say', info: 'info', pair: 'pair', diff: 'diff',
+  tiny: 'tiny', hat: 'hat', flip: 'flip', fortune: 'fortune',
+  theme: 'theme', animate: 'animate', motd: 'motd', calendar: 'calendar',
+  commit: 'commit', ci: 'ci', gif: 'gif', png: 'png', svg: 'svg',
+  stretch: 'stretch', squish: 'squish', stretchv: 'stretchv', squishv: 'squishv',
+  white: 'white', label: 'label', delay: 'delay', slide: 'slide', fall: 'fall', shatter: 'shatter',
+}
+const cleaned = []
+for (let i = 0; i < positional.length; i++) {
+  const word = positional[i].toLowerCase()
+  if (flagWords[word] && !flags[flagWords[word]]) {
+    const key = flagWords[word]
+    if (key === 'say') {
+      const words = []
+      while (i + 1 < positional.length && !flagWords[positional[i + 1]?.toLowerCase()]) {
+        words.push(positional[++i])
+      }
+      if (words.length) flags.say = words.join(' ')
+    } else if (key === 'label') {
+      const words = []
+      while (i + 1 < positional.length && !flagWords[positional[i + 1]?.toLowerCase()]) {
+        words.push(positional[++i])
+      }
+      if (words.length) flags.label = words.join(' ')
+    } else if (['tiny', 'hat', 'flip', 'fortune', 'motd', 'calendar', 'commit', 'ci', 'stretch', 'squish', 'stretchv', 'squishv', 'white', 'delay', 'slide', 'fall', 'shatter'].includes(key)) {
+      flags[key] = true
+    } else if (i + 1 < positional.length && !flagWords[positional[i + 1]?.toLowerCase()]) {
+      flags[key] = positional[++i]
+    } else {
+      flags[key] = true
+    }
+  } else {
+    cleaned.push(positional[i])
+  }
+}
+positional.length = 0
+positional.push(...cleaned)
+
+const cmdWords = ['all', 'random', 'browse', 'list', 'count', 'help']
+const cmd = (cmdWords.includes(positional[0]) ? positional[0] : null)
+  || Object.keys(flags).find(f => cmdWords.includes(f))
+  || positional[0]
+
+function output(art) {
+  if (flags.noColor) return stripAnsi(art)
+  return art
+}
+
+function applyPipeline(art) {
+  if (flags.hat) art = addHat(art)
+  if (flags.theme) {
+    const { applyTheme } = require('./theme')
+    art = applyTheme(art, flags.theme)
+  }
+  if (flags.stretch) art = stretchArt(art)
+  if (flags.squish) art = squishArt(art)
+  if (flags.stretchv) art = stretchVArt(art)
+  if (flags.squishv) art = squishVArt(art)
+  if (flags.flip) art = flipArt(art)
+  if (flags.say) art = addSay(art, flags.say)
+  if (flags.label) art = addLabel(art, flags.label)
+  return art
+}
+
+const HIDE = '\x1b[?25l'
+const SHOW = '\x1b[?25h'
+const RESET = '\x1b[0m'
+const CLEAR = '\x1b[2J\x1b[H'
+
+function parseArtCells(art) {
+  const lines = art.split('\n')
+  const cells = []
+  let maxCol = 0
+  for (let row = 0; row < lines.length; row++) {
+    const line = lines[row]
+    let currentStyle = ''
+    let col = 0
+    let i = 0
+    while (i < line.length) {
+      if (line[i] === '\x1b' && i + 1 < line.length && line[i + 1] === '[') {
+        let j = i + 2
+        while (j < line.length && line[j] !== 'm') j++
+        const code = line.slice(i, j + 1)
+        if (code === '\x1b[0m') currentStyle = ''
+        else currentStyle += code
+        i = j + 1
+      } else {
+        if (line[i] !== ' ') {
+          cells.push({ row, col, style: currentStyle, char: line[i] })
+          if (col > maxCol) maxCol = col
+        }
+        col++
+        i++
+      }
+    }
+  }
+  return { cells, height: lines.length, width: maxCol + 1 }
+}
+
+function animSetup(label) {
+  process.stdout.write(HIDE + CLEAR)
+  let artStartRow = 1
+  if (label) {
+    process.stdout.write(output(label) + '\n')
+    artStartRow = 2
+  }
+  return artStartRow
+}
+
+function animCleanup(height, artStartRow) {
+  process.stdout.write(`\x1b[${height + artStartRow};1H` + SHOW)
+}
+
+function drawCells(cells, artStartRow, offR, offC, termW, termH) {
+  let buf = ''
+  for (const c of cells) {
+    const r = c.row + artStartRow + (offR || 0)
+    const col = c.col + 1 + (offC || 0)
+    if (r < 1 || col < 1 || (termH && r > termH) || (termW && col > termW)) continue
+    buf += `\x1b[${r};${col}H${RESET}${c.style}${c.char}`
+  }
+  buf += RESET
+  process.stdout.write(buf)
+}
+
+function delayReveal(art, label) {
+  if (!process.stdout.isTTY) {
+    if (label) console.log(output(label))
+    console.log(output(art))
+    return
+  }
+
+  const { cells, height } = parseArtCells(art)
+
+  // Fisher-Yates shuffle
+  for (let i = cells.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1))
+    ;[cells[i], cells[j]] = [cells[j], cells[i]]
+  }
+
+  const artStartRow = animSetup(label)
+
+  const totalSteps = 20
+  const batchSize = Math.max(1, Math.ceil(cells.length / totalSteps))
+  let idx = 0
+
+  function step() {
+    const end = Math.min(idx + batchSize, cells.length)
+    let buf = ''
+    for (let i = idx; i < end; i++) {
+      const c = cells[i]
+      buf += `\x1b[${c.row + artStartRow};${c.col + 1}H${RESET}${c.style}${c.char}`
+    }
+    buf += RESET
+    process.stdout.write(buf)
+    idx = end
+    if (idx < cells.length) {
+      setTimeout(step, 60)
+    } else {
+      animCleanup(height, artStartRow)
+    }
+  }
+
+  process.on('SIGINT', () => { animCleanup(height, artStartRow); process.exit(0) })
+  step()
+}
+
+function slideReveal(art, label) {
+  if (!process.stdout.isTTY) {
+    if (label) console.log(output(label))
+    console.log(output(art))
+    return
+  }
+
+  const { cells, height, width } = parseArtCells(art)
+  const termW = process.stdout.columns || 80
+  const artStartRow = animSetup(label)
+
+  const startOffset = termW
+  const totalFrames = 18
+  let frame = 0
+
+  function step() {
+    const t = frame / (totalFrames - 1) // 0 to 1
+    // ease-out: decelerate as it arrives
+    const ease = 1 - Math.pow(1 - t, 3)
+    const offset = Math.round(startOffset * (1 - ease))
+
+    process.stdout.write(CLEAR)
+    if (label) {
+      process.stdout.write(`\x1b[1;1H${output(label)}`)
+    }
+    drawCells(cells, artStartRow, 0, offset, termW, null)
+
+    frame++
+    if (frame < totalFrames) {
+      setTimeout(step, 45)
+    } else {
+      animCleanup(height, artStartRow)
+    }
+  }
+
+  process.on('SIGINT', () => { animCleanup(height, artStartRow); process.exit(0) })
+  step()
+}
+
+function fallReveal(art, label) {
+  if (!process.stdout.isTTY) {
+    if (label) console.log(output(label))
+    console.log(output(art))
+    return
+  }
+
+  const { cells, height } = parseArtCells(art)
+  const termH = process.stdout.rows || 24
+  const artStartRow = animSetup(label)
+
+  const startOffset = -(height + artStartRow)
+  const totalFrames = 20
+  let frame = 0
+
+  function step() {
+    const t = frame / (totalFrames - 1)
+    // bounce ease: overshoot then settle
+    let ease
+    if (t < 0.7) {
+      ease = (t / 0.7)
+    } else if (t < 0.85) {
+      ease = 1 + 0.15 * Math.sin((t - 0.7) / 0.15 * Math.PI)
+    } else {
+      ease = 1
+    }
+    const offset = Math.round(startOffset * (1 - ease))
+
+    process.stdout.write(CLEAR)
+    if (label) {
+      process.stdout.write(`\x1b[1;1H${output(label)}`)
+    }
+    drawCells(cells, artStartRow, offset, 0, null, termH)
+
+    frame++
+    if (frame < totalFrames) {
+      setTimeout(step, 45)
+    } else {
+      animCleanup(height, artStartRow)
+    }
+  }
+
+  process.on('SIGINT', () => { animCleanup(height, artStartRow); process.exit(0) })
+  step()
+}
+
+function shatterReveal(art, label) {
+  if (!process.stdout.isTTY) {
+    if (label) console.log(output(label))
+    console.log(output(art))
+    return
+  }
+
+  const { cells, height, width } = parseArtCells(art)
+  const termW = process.stdout.columns || 80
+  const termH = process.stdout.rows || 24
+  const artStartRow = animSetup(label)
+
+  // Draw the full art first
+  drawCells(cells, artStartRow, 0, 0, null, null)
+
+  // After a pause, shatter
+  setTimeout(() => {
+    // Give each cell physics properties
+    const particles = cells.map(c => ({
+      x: c.col,
+      y: c.row,
+      vx: (Math.random() - 0.5) * 4,
+      vy: -(Math.random() * 3 + 1),
+      style: c.style,
+      char: c.char,
+    }))
+
+    const gravity = 0.35
+    let frame = 0
+    const maxFrames = 40
+
+    function step() {
+      process.stdout.write(CLEAR)
+      if (label) {
+        process.stdout.write(`\x1b[1;1H${output(label)}`)
+      }
+
+      let anyVisible = false
+      let buf = ''
+      for (const p of particles) {
+        p.vy += gravity
+        p.x += p.vx
+        p.y += p.vy
+
+        const r = Math.round(p.y) + artStartRow
+        const col = Math.round(p.x) + 1
+        if (r >= 1 && r <= termH && col >= 1 && col <= termW) {
+          buf += `\x1b[${r};${col}H${RESET}${p.style}${p.char}`
+          anyVisible = true
+        }
+      }
+      buf += RESET
+      process.stdout.write(buf)
+
+      frame++
+      if (frame < maxFrames && anyVisible) {
+        setTimeout(step, 40)
+      } else {
+        process.stdout.write(CLEAR)
+        animCleanup(0, 1)
+      }
+    }
+
+    step()
+  }, 800)
+
+  process.on('SIGINT', () => { process.stdout.write(CLEAR); animCleanup(0, 1); process.exit(0) })
+}
+
+function exportOrPrint(art, label) {
+  const bgColor = flags.white ? [255, 255, 255] : undefined
+  const exported = []
+  if (flags.gif) {
+    const { generateGif } = require('./gif')
+    const path = typeof flags.gif === 'string' ? flags.gif : 'meeb.gif'
+    generateGif(art, path, bgColor)
+    exported.push(path)
+  }
+  if (flags.png) {
+    const { generatePng } = require('./png')
+    const path = typeof flags.png === 'string' ? flags.png : 'meeb.png'
+    generatePng(art, path, bgColor)
+    exported.push(path)
+  }
+  if (flags.svg) {
+    const { generateSvg } = require('./svg')
+    const path = typeof flags.svg === 'string' ? flags.svg : 'meeb.svg'
+    generateSvg(art, path, bgColor)
+    exported.push(path)
+  }
+  if (exported.length > 0) {
+    console.log(`  saved to ${exported.join(', ')}`)
+  } else if (flags.delay) {
+    delayReveal(output(art), label ? output(label) : null)
+  } else if (flags.slide) {
+    slideReveal(output(art), label ? output(label) : null)
+  } else if (flags.fall) {
+    fallReveal(output(art), label ? output(label) : null)
+  } else if (flags.shatter) {
+    shatterReveal(output(art), label ? output(label) : null)
+  } else {
+    if (label) console.log(output(label))
+    console.log(output(art))
+  }
+}
+
+function levenshtein(a, b) {
+  const m = a.length, n = b.length
+  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1))
+  for (let i = 0; i <= m; i++) dp[i][0] = i
+  for (let j = 0; j <= n; j++) dp[0][j] = j
+  for (let i = 1; i <= m; i++)
+    for (let j = 1; j <= n; j++)
+      dp[i][j] = Math.min(
+        dp[i - 1][j] + 1,
+        dp[i][j - 1] + 1,
+        dp[i - 1][j - 1] + (a[i - 1] !== b[j - 1] ? 1 : 0)
+      )
+  return dp[m][n]
+}
+
+function resolveAnimal(name) {
+  const resolved = emojiResolve(name)
+  let animal = animals[resolved || name]
+  if (animal) return animal
+
+  const input = name.toLowerCase()
+  const names = Object.keys(animals)
+
+  const sub = names.find(n => n.startsWith(input) || input.startsWith(n))
+    || names.find(n => n.includes(input) || input.includes(n))
+
+  if (sub) return animals[sub]
+
+  let best = null, bestD = Infinity
+  for (const n of names) {
+    const d = levenshtein(input, n)
+    if (d < bestD) { bestD = d; best = n }
+  }
+  if (best && bestD <= Math.max(2, Math.ceil(input.length / 3))) {
+    return animals[best]
+  }
+  return null
+}
+
+function getRandomAnimal() {
+  const keys = Object.keys(visible)
+  return visible[keys[Math.floor(Math.random() * keys.length)]]
+}
+
+function renderAnimal(animal) {
+  return flags.tiny && animal.tiny ? animal.tiny() : animal.render()
+}
+
+// --- Pipe stdin support ---
+// If stdin is piped, read it as --say message
+function readStdin() {
+  if (process.stdin.isTTY) return null
+  try {
+    const fs = require('fs')
+    const input = fs.readFileSync(0, 'utf8').trim()
+    return input || null
+  } catch {
+    return null
+  }
+}
+
+const stdinMsg = readStdin()
+if (stdinMsg && !flags.say) {
+  flags.say = stdinMsg
+}
+
+// --- Help ---
+if ((!cmd && Object.keys(flags).length === 0) || cmd === 'help') {
+  console.log('')
+  console.log(rgb(215, 119, 87, '  meeb') + ' — cute ascii animals for your terminal')
+  console.log('')
+  console.log('  Usage: meeb <animal> [flags]')
+  console.log('         echo "hello" | meeb penguin')
+  console.log('')
+  console.log('  Animals:')
+  for (const name of Object.keys(visible)) {
+    console.log(`    ${rgb(215, 119, 87, '●')} ${name}`)
+  }
+  console.log('')
+  console.log('  Commands:')
+  console.log('    --all              show all animals')
+  console.log('    --random           show a random animal')
+  console.log('    --list             print names only (for scripting)')
+  console.log('    --count            print total number of animals')
+  console.log('    --browse           interactive TUI to browse animals')
+  console.log('')
+  console.log('  Display:')
+  console.log('    --say "msg"        speech bubble above the animal')
+  console.log('    --tiny             compact 4-5 row version')
+  console.log('    --hat              seasonal hat (auto-detects month)')
+  console.log('    --flip             mirror the animal horizontally')
+  console.log('    --fortune          random fortune as speech bubble')
+  console.log('    --theme <name>     color theme (neon, pastel, retro, mono, matrix)')
+  console.log('    --label "text"     subtitle text below the animal')
+  console.log('    --no-color         strip ANSI codes (for piping)')
+  console.log('')
+  console.log('  Transforms:')
+  console.log('    --stretch          stretch horizontally (wider)')
+  console.log('    --squish           squish horizontally (narrower)')
+  console.log('    --stretchv         stretch vertically (taller)')
+  console.log('    --squishv          squish vertically (shorter)')
+  console.log('')
+  console.log('  Animations:')
+  console.log('    --delay            pixels materialize randomly')
+  console.log('    --slide            slide in from the right')
+  console.log('    --fall             drop from the top with a bounce')
+  console.log('    --shatter          appear then explode with gravity')
+  console.log('')
+  console.log('  Features:')
+  console.log('    --motd             message of the day (for .bashrc/.zshrc)')
+  console.log('    --pair <animal>    show two animals side by side')
+  console.log('    --diff <animal>    compare two animals side by side')
+  console.log('    --animate <animal> terminal animation (3 frames)')
+  console.log('    --info <animal>    fun fact about the animal')
+  console.log('    --calendar         animal of the day')
+  console.log('    --commit           git commit message as speech bubble')
+  console.log('    --ci               markdown-safe output (no ANSI)')
+  console.log('')
+  console.log('  Export:')
+  console.log('    --gif [path]       save as gif (default: meeb.gif)')
+  console.log('    --png [path]       save as png (default: meeb.png)')
+  console.log('    --svg [path]       save as svg (default: meeb.svg)')
+  console.log('    --white            white background for exports')
+  console.log('')
+  console.log('  Setup:')
+  console.log('    --install-completions   install shell completions (bash/zsh/fish)')
+  console.log('')
+  console.log('  Emoji:')
+  console.log('    meeb 🐧             looks up the matching animal')
+  console.log('')
+  process.exit(0)
+}
+
+if (cmd === 'list') {
+  console.log(Object.keys(visible).join('\n'))
+  process.exit(0)
+}
+
+if (cmd === 'count') {
+  console.log(Object.keys(visible).length)
+  process.exit(0)
+}
+
+// --- --install-completions ---
+if (flags['install-completions']) {
+  const fs = require('fs')
+  const path = require('path')
+  const os = require('os')
+  const shell = (process.env.SHELL || '').split('/').pop()
+  const completionsDir = path.join(__dirname, 'completions')
+
+  if (shell === 'zsh') {
+    const src = path.join(completionsDir, '_meeb')
+    const dest = path.join(os.homedir(), '.zsh', 'completions', '_meeb')
+    const destDir = path.dirname(dest)
+    if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true })
+    fs.copyFileSync(src, dest)
+    console.log(`  Installed zsh completions to ${dest}`)
+    console.log(`  Add to .zshrc: fpath=(~/.zsh/completions $fpath)`)
+    console.log(`  Then run: autoload -Uz compinit && compinit`)
+  } else if (shell === 'bash') {
+    const src = path.join(completionsDir, 'meeb.bash')
+    const dest = path.join(os.homedir(), '.bash_completion.d', 'meeb.bash')
+    const destDir = path.dirname(dest)
+    if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true })
+    fs.copyFileSync(src, dest)
+    console.log(`  Installed bash completions to ${dest}`)
+    console.log(`  Add to .bashrc: source ~/.bash_completion.d/meeb.bash`)
+  } else if (shell === 'fish') {
+    const fishDir = path.join(os.homedir(), '.config', 'fish', 'completions')
+    if (!fs.existsSync(fishDir)) fs.mkdirSync(fishDir, { recursive: true })
+    const dest = path.join(fishDir, 'meeb.fish')
+    // generate fish completions
+    const animalNames = Object.keys(visible).join(' ')
+    const fishContent = [
+      '# meeb fish completions',
+      `complete -c meeb -f -a "${animalNames}"`,
+      'complete -c meeb -l all -d "show all animals"',
+      'complete -c meeb -l random -d "show a random animal"',
+      'complete -c meeb -l list -d "print names only"',
+      'complete -c meeb -l count -d "print total number"',
+      'complete -c meeb -l say -d "speech bubble" -r',
+      'complete -c meeb -l tiny -d "compact version"',
+      'complete -c meeb -l hat -d "seasonal hat"',
+      'complete -c meeb -l flip -d "mirror horizontally"',
+      'complete -c meeb -l fortune -d "random fortune"',
+      'complete -c meeb -l theme -d "color theme" -r -a "neon pastel retro mono matrix"',
+      'complete -c meeb -l motd -d "message of the day"',
+      'complete -c meeb -l pair -d "two animals side by side" -r',
+      'complete -c meeb -l diff -d "compare two animals" -r',
+      'complete -c meeb -l animate -d "terminal animation" -r',
+      'complete -c meeb -l info -d "fun animal fact" -r',
+      'complete -c meeb -l calendar -d "animal of the day"',
+      'complete -c meeb -l commit -d "git commit speech bubble"',
+      'complete -c meeb -l ci -d "markdown-safe output"',
+      'complete -c meeb -l gif -d "save as gif"',
+      'complete -c meeb -l png -d "save as png"',
+      'complete -c meeb -l svg -d "save as svg"',
+      'complete -c meeb -l browse -d "interactive TUI"',
+      'complete -c meeb -l no-color -d "strip ANSI codes"',
+      'complete -c meeb -l install-completions -d "install shell completions"',
+    ].join('\n') + '\n'
+    fs.writeFileSync(dest, fishContent)
+    console.log(`  Installed fish completions to ${dest}`)
+  } else {
+    console.log(`  Unsupported shell: ${shell || '(unknown)'}`)
+    console.log(`  Manual install: copy files from ${completionsDir}`)
+  }
+  process.exit(0)
+}
+
+// --fortune implies --say with a random fortune
+if (flags.fortune && !flags.say) {
+  flags.say = getFortune()
+}
+
+// --- --motd: compact random animal + fortune for shell startup ---
+if (flags.motd) {
+  const animal = getRandomAnimal()
+  let art = animal.tiny ? animal.tiny() : animal.render()
+  art = addSay(art, getFortune())
+  if (flags.theme) {
+    const { applyTheme } = require('./theme')
+    art = applyTheme(art, flags.theme)
+  }
+  console.log(output(art))
+  process.exit(0)
+}
+
+// --- --calendar: deterministic animal of the day ---
+if (flags.calendar) {
+  const now = new Date()
+  const dayOfYear = Math.floor((now - new Date(now.getFullYear(), 0, 0)) / 86400000)
+  const keys = Object.keys(visible)
+  const pick = keys[dayOfYear % keys.length]
+  const animal = visible[pick]
+  let art = renderAnimal(animal)
+  art = applyPipeline(art)
+  const dateStr = now.toLocaleDateString('en-US', { weekday: 'long', month: 'long', day: 'numeric' })
+  console.log(output(rgb(215, 119, 87, `  ── ${animal.name} ── `) + rgb(120, 120, 120, dateStr)))
+  console.log(output(art))
+  process.exit(0)
+}
+
+// --- --commit: git post-commit hook helper ---
+if (flags.commit) {
+  const { execSync } = require('child_process')
+  let msg
+  try {
+    msg = execSync('git log -1 --pretty=%s 2>/dev/null', { encoding: 'utf8' }).trim()
+  } catch {
+    msg = 'committed!'
+  }
+  if (!flags.say) flags.say = msg
+  const animal = getRandomAnimal()
+  let art = renderAnimal(animal)
+  art = applyPipeline(art)
+  console.log(output(art))
+  process.exit(0)
+}
+
+// --- --ci: markdown-compatible output (no ANSI) ---
+if (flags.ci) {
+  const animalName = typeof flags.ci === 'string' ? flags.ci : (positional[0] || null)
+  const animal = animalName ? resolveAnimal(animalName) : getRandomAnimal()
+  if (!animal) {
+    console.error(`  unknown animal: "${animalName}"`)
+    process.exit(1)
+  }
+  let art = renderAnimal(animal)
+  if (flags.hat) art = addHat(art)
+  if (flags.flip) art = flipArt(art)
+  if (flags.say) art = addSay(art, flags.say)
+  // Output as markdown code block with no ANSI
+  console.log('```')
+  console.log(stripAnsi(art))
+  console.log('```')
+  process.exit(0)
+}
+
+// --- --info: fun animal fact ---
+if (flags.info) {
+  const { getInfo } = require('./info')
+  const animalName = typeof flags.info === 'string' ? flags.info : (positional[0] || null)
+  const animal = animalName ? resolveAnimal(animalName) : getRandomAnimal()
+  if (!animal) {
+    console.error(`  unknown animal: "${animalName}"`)
+    process.exit(1)
+  }
+  let art = renderAnimal(animal)
+  const fact = getInfo(animalName || Object.keys(animals).find(k => animals[k] === animal) || '')
+  if (!flags.say) flags.say = fact
+  art = applyPipeline(art)
+  console.log(output(rgb(215, 119, 87, `  ── ${animal.name} ──`)))
+  console.log(output(art))
+  process.exit(0)
+}
+
+// --- --pair: two animals side by side ---
+if (flags.pair) {
+  const animal1Name = positional[0]
+  const animal2Name = typeof flags.pair === 'string' ? flags.pair : null
+  if (!animal1Name || !animal2Name) {
+    console.error('  Usage: meeb <animal1> --pair <animal2>')
+    process.exit(1)
+  }
+  const a1 = resolveAnimal(animal1Name)
+  const a2 = resolveAnimal(animal2Name)
+  if (!a1) { console.error(`  unknown animal: "${animal1Name}"`); process.exit(1) }
+  if (!a2) { console.error(`  unknown animal: "${animal2Name}"`); process.exit(1) }
+
+  let art1 = renderAnimal(a1)
+  let art2 = renderAnimal(a2)
+  if (flags.hat) { art1 = addHat(art1); art2 = addHat(art2) }
+  if (flags.theme) {
+    const { applyTheme } = require('./theme')
+    art1 = applyTheme(art1, flags.theme)
+    art2 = applyTheme(art2, flags.theme)
+  }
+  const combined = sideBySide(art1, art2, 4)
+  console.log(output(rgb(215, 119, 87, `  ── ${a1.name} & ${a2.name} ──`)))
+  console.log(output(combined))
+  process.exit(0)
+}
+
+// --- --diff: compare two animals side by side (with labels) ---
+if (flags.diff) {
+  const animal1Name = positional[0]
+  const animal2Name = typeof flags.diff === 'string' ? flags.diff : null
+  if (!animal1Name || !animal2Name) {
+    console.error('  Usage: meeb <animal1> --diff <animal2>')
+    process.exit(1)
+  }
+  const a1 = resolveAnimal(animal1Name)
+  const a2 = resolveAnimal(animal2Name)
+  if (!a1) { console.error(`  unknown animal: "${animal1Name}"`); process.exit(1) }
+  if (!a2) { console.error(`  unknown animal: "${animal2Name}"`); process.exit(1) }
+
+  let art1 = renderAnimal(a1)
+  let art2 = renderAnimal(a2)
+  if (flags.theme) {
+    const { applyTheme } = require('./theme')
+    art1 = applyTheme(art1, flags.theme)
+    art2 = applyTheme(art2, flags.theme)
+  }
+
+  // Add labels above each
+  const label1 = rgb(215, 119, 87, `  ${a1.name}`)
+  const label2 = rgb(215, 119, 87, `  ${a2.name}`)
+  art1 = label1 + '\n' + art1
+  art2 = label2 + '\n' + art2
+
+  const combined = sideBySide(art1, art2, 6)
+  console.log(output(combined))
+  process.exit(0)
+}
+
+// --- --animate: terminal animation ---
+if (flags.animate) {
+  const animalName = typeof flags.animate === 'string' ? flags.animate : (positional[0] || null)
+  const animal = animalName ? resolveAnimal(animalName) : getRandomAnimal()
+  if (!animal) {
+    console.error(`  unknown animal: "${animalName}"`)
+    process.exit(1)
+  }
+
+  if (!process.stdout.isTTY) {
+    console.error('  --animate requires an interactive terminal')
+    process.exit(1)
+  }
+
+  const clear = '\x1b[2J\x1b[H'
+  const hide = '\x1b[?25l'
+  const show = '\x1b[?25h'
+
+  // Generate frames — normal, eyes closed (replace ◉/● with ─), normal
+  const base = renderAnimal(animal)
+  const blink = base
+    .replace(/◉/g, '─')
+    .replace(/●/g, '─')
+    .replace(/◆/g, '─')
+
+  let frames = [base, base, base, blink, base, base]
+  if (flags.hat) frames = frames.map(f => addHat(f))
+  if (flags.theme) {
+    const { applyTheme } = require('./theme')
+    frames = frames.map(f => applyTheme(f, flags.theme))
+  }
+
+  const label = rgb(215, 119, 87, `  ── ${animal.name} ──`)
+
+  process.stdout.write(hide)
+  let frame = 0
+  const interval = setInterval(() => {
+    process.stdout.write(clear + label + '\n' + frames[frame % frames.length] + '\n')
+    frame++
+  }, 400)
+
+  // Run for 6 seconds then stop
+  setTimeout(() => {
+    clearInterval(interval)
+    process.stdout.write(show)
+    process.exit(0)
+  }, 6000)
+
+  // Clean exit on ctrl-c
+  process.on('SIGINT', () => {
+    clearInterval(interval)
+    process.stdout.write(show + clear)
+    process.exit(0)
+  })
+
+  // prevent falling through
+  return
+}
+
+// --browse launches TUI
+if (cmd === 'browse' || flags.browse) {
+  const { browse } = require('./tui')
+  browse(visible)
+  // browse takes over — no further code runs
+}
+
+if (cmd === 'random') {
+  const animal = getRandomAnimal()
+  let art = renderAnimal(animal)
+  art = applyPipeline(art)
+  exportOrPrint(art, rgb(215, 119, 87, `  ── ${animal.name} ──`))
+  process.exit(0)
+}
+
+if (cmd === 'all') {
+  for (const animal of Object.values(visible)) {
+    let art = renderAnimal(animal)
+    if (flags.hat) art = addHat(art)
+    if (flags.flip) art = flipArt(art)
+    if (flags.theme) {
+      const { applyTheme } = require('./theme')
+      art = applyTheme(art, flags.theme)
+    }
+    exportOrPrint(art, rgb(215, 119, 87, `  ── ${animal.name} ──`))
+  }
+  process.exit(0)
+}
+
+// no command and no animal? pick random if we have modifier flags, else show help
+if (!cmd) {
+  if (Object.keys(flags).length > 0) {
+    const keys = Object.keys(animals)
+    const pick = keys[Math.floor(Math.random() * keys.length)]
+    const animal = animals[pick]
+    let art = renderAnimal(animal)
+    art = applyPipeline(art)
+    exportOrPrint(art, rgb(215, 119, 87, `  ── ${animal.name} ──`))
+    process.exit(0)
+  }
+  process.exit(0)
+}
+
+// try emoji lookup, then fuzzy match
+const resolved = emojiResolve(cmd)
+let animal = animals[resolved || cmd]
+if (!animal) {
+  const input = cmd.toLowerCase()
+  const names = Object.keys(animals)
+
+  // try substring match first (handles "croc" → "crocodile", "jelly" → "jellyfish")
+  const sub = names.find(n => n.startsWith(input) || input.startsWith(n))
+    || names.find(n => n.includes(input) || input.includes(n))
+
+  if (sub) {
+    console.error(`  did you mean ${rgb(215, 119, 87, sub)}?`)
+    animal = animals[sub]
+  } else {
+    // fuzzy match via levenshtein
+    let best = null, bestD = Infinity
+    for (const name of names) {
+      const d = levenshtein(input, name)
+      if (d < bestD) { bestD = d; best = name }
+    }
+    if (best && bestD <= Math.max(2, Math.ceil(input.length / 3))) {
+      console.error(`  did you mean ${rgb(215, 119, 87, best)}?`)
+      animal = animals[best]
+    } else {
+      console.error(`  unknown animal: "${cmd}"`)
+      console.error(`  try: meeb --list`)
+      process.exit(1)
+    }
+  }
+}
+
+let art = renderAnimal(animal)
+art = applyPipeline(art)
+exportOrPrint(art)
+
+// Easter egg: stretched snail is the meeb logo
+const animalKey = Object.keys(animals).find(k => animals[k] === animal)
+if (animalKey === 'snail' && flags.stretch) {
+  console.log('')
+  console.log(rgb(215, 119, 87, '  AHA! THE MEEB LOGO! WHAT A WONDERFUL SIGHT!'))
+}