next-prune 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 The next-prune Contributors
+
+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/dist/app.js

@@ -0,0 +1,474 @@
+import process from 'node:process';
+import path from 'node:path';
+import React, { useState, useEffect, useMemo } from 'react';
+import { Box, Text } from 'ink';
+import { findNextCaches, getDirSize, FRAMES, human } from './scanner.js';
+
+// Scanner utilities are imported from ./scanner.js
+
+function useSpinner(active) {
+  const [i, setI] = useState(0);
+  useEffect(() => {
+    if (!active) return;
+    const t = setInterval(() => setI(x => (x + 1) % FRAMES.length), 80);
+    return () => clearInterval(t);
+  }, [active]);
+  return FRAMES[i];
+}
+function useTerminalCols() {
+  const [cols, setCols] = useState(process.stdout?.columns || 80);
+  useEffect(() => {
+    const onResize = () => setCols(process.stdout?.columns || 80);
+    process.stdout?.on?.('resize', onResize);
+    return () => process.stdout?.off?.('resize', onResize);
+  }, []);
+  return cols;
+}
+function useTerminalRows() {
+  const [rows, setRows] = useState(process.stdout?.rows || 24);
+  useEffect(() => {
+    const onResize = () => setRows(process.stdout?.rows || 24);
+    process.stdout?.on?.('resize', onResize);
+    return () => process.stdout?.off?.('resize', onResize);
+  }, []);
+  return rows;
+}
+
+// Greedy pack segments into up to maxLines based on terminal width
+function packSegments(segments, cols, maxLines = 3) {
+  const sep = ' • ';
+  const prefixLen = 3; // approx width of '🎮 '
+  const max = Math.max(24, (cols || 80) - 6); // leave room for borders/padding
+  const lines = [];
+  let cur = [];
+  let curLen = prefixLen; // first line has a small prefix
+  const pushLine = () => {
+    if (cur.length > 0) lines.push(cur);
+    cur = [];
+    curLen = 0;
+  };
+  for (const seg of segments) {
+    const segText = `${seg.key} ${seg.label}`;
+    const addLen = (cur.length === 0 ? 0 : sep.length) + segText.length;
+    const isLastLine = lines.length >= maxLines - 1;
+    if (!isLastLine && cur.length > 0 && curLen + addLen > max) {
+      pushLine();
+    }
+    cur.push(seg);
+    curLen += cur.length === 1 ? segText.length : addLen;
+  }
+  if (cur.length > 0) lines.push(cur);
+  return lines.slice(0, maxLines);
+}
+
+// Similar to packSegments but for {label, value} pairs
+function packLabeledSegments(segments, cols, prefixLen = 0, maxLines = 3) {
+  const sepLen = 3; // ' • '
+  const max = Math.max(24, (cols || 80) - 6);
+  const lines = [];
+  let cur = [];
+  let curLen = prefixLen;
+  const pushLine = () => {
+    if (cur.length > 0) lines.push(cur);
+    cur = [];
+    curLen = 0;
+  };
+  for (const seg of segments) {
+    const segLen = seg.label.length + 1 + String(seg.value).length; // space before value
+    const addLen = (cur.length === 0 ? 0 : sepLen) + segLen;
+    if (cur.length > 0 && curLen + addLen > max) {
+      pushLine();
+    }
+    cur.push(seg);
+    curLen += cur.length === 1 ? segLen : addLen;
+  }
+  if (cur.length > 0) lines.push(cur);
+  return lines.slice(0, maxLines);
+}
+function truncateMiddle(text, max) {
+  if (!text) return '';
+  if (max <= 0) return '';
+  if (text.length <= max) return text;
+  if (max <= 1) return '…';
+  const head = Math.ceil((max - 1) / 2);
+  const tail = Math.floor((max - 1) / 2);
+  return text.slice(0, head) + '…' + text.slice(text.length - tail);
+}
+export default function App({
+  cwd = process.cwd(),
+  dryRun = false,
+  confirmImmediately = false,
+  testMode = false
+}) {
+  const [items, setItems] = useState([]); // {path, size, status}
+  const [loading, setLoading] = useState(!testMode);
+  const [selected, setSelected] = useState(new Set());
+  const [index, setIndex] = useState(0);
+  const [confirm, setConfirm] = useState(false);
+  const [error, setError] = useState('');
+  const [showHelp, setShowHelp] = useState(false);
+  const spinner = useSpinner(loading);
+  const cols = useTerminalCols();
+  const rows = useTerminalRows();
+  const hasSelection = selected.size > 0;
+  const footerSegments = useMemo(() => {
+    if (hasSelection) {
+      return [{
+        key: 'Space',
+        label: 'toggle'
+      }, {
+        key: 'D/Enter',
+        label: 'delete'
+      }, {
+        key: 'C',
+        label: 'clear'
+      }, {
+        key: 'H',
+        label: 'help'
+      }, {
+        key: 'Q',
+        label: 'quit'
+      }];
+    }
+    return [{
+      key: '↑↓',
+      label: 'move'
+    }, {
+      key: 'Space',
+      label: 'select'
+    }, {
+      key: 'A',
+      label: 'all'
+    }, {
+      key: 'R',
+      label: 'rescan'
+    }, {
+      key: 'H',
+      label: 'help'
+    }, {
+      key: 'Q',
+      label: 'quit'
+    }];
+  }, [hasSelection]);
+  const packedLines = useMemo(() => packSegments(footerSegments, cols, 3), [footerSegments, cols]);
+  const totalSize = useMemo(() => {
+    let sum = 0;
+    for (const it of items) {
+      if (it.status !== 'deleted') {
+        sum += typeof it.size === 'number' ? it.size : 0;
+      }
+    }
+    return sum;
+  }, [items]);
+  const selectedSize = useMemo(() => {
+    let sum = 0;
+    let idx = 0;
+    for (const it of items) {
+      if (selected.has(idx)) sum += typeof it.size === 'number' ? it.size : 0;
+      idx += 1;
+    }
+    return sum;
+  }, [items, selected]);
+  const foundCount = useMemo(() => items.filter(it => it.status !== 'deleted').length, [items]);
+  const truncatedCwd = useMemo(() => {
+    const labelLen = 'Scan Directory:'.length;
+    const max = Math.max(10, (cols || 80) - labelLen - 6);
+    return truncateMiddle(cwd, max);
+  }, [cwd, cols]);
+  const scanSegments = useMemo(() => {
+    const segs = [{
+      label: 'Found:',
+      value: `${foundCount} directories`
+    }, {
+      label: 'Total Size:',
+      value: human(totalSize)
+    }, {
+      label: 'Selected:',
+      value: `${selected.size} (${human(selectedSize)})`
+    }];
+    if (loading) segs.push({
+      label: 'Status:',
+      value: `${spinner} scanning...`
+    });
+    return segs;
+  }, [foundCount, totalSize, selected.size, selectedSize, loading, spinner]);
+  const packedScan = useMemo(() => packLabeledSegments(scanSegments, cols, 0, 3), [scanSegments, cols]);
+
+  // Viewport sizing to avoid terminal jumping on navigation
+  const {
+    listBoxHeight,
+    viewStart,
+    viewEnd
+  } = useMemo(() => {
+    const rootPad = 2; // root <Box padding={1}> adds 2 rows total
+    const titleHeight = 5; // round border + padding + 1 line
+    const scanHeight = 5 + packedScan.length; // single border + padding + header + lines
+    const errorHeight = error ? 5 : 0; // approx single-line error box
+    const footerHeight = showHelp ? 10 : 4 + packedLines.length; // help ~6 lines + borders/padding => 10; else compact footer
+    const confirmHeight = confirm ? 7 : 0; // confirm box ~3 lines + borders/padding
+    const used = rootPad + titleHeight + scanHeight + errorHeight + footerHeight + confirmHeight;
+    const totalRows = rows || 24;
+    const boxHeight = Math.max(7, totalRows - used); // include list borders+padding
+    const inner = Math.max(3, boxHeight - 4); // subtract list border+padding
+
+    // Center the focused item within the visible window when possible
+    const half = Math.floor(inner / 2);
+    let start = Math.max(0, index - half);
+    let end = start + inner;
+    if (end > items.length) {
+      end = items.length;
+      start = Math.max(0, end - inner);
+    }
+    return {
+      listBoxHeight: boxHeight,
+      viewStart: start,
+      viewEnd: end
+    };
+  }, [rows, packedScan.length, error, showHelp, packedLines.length, confirm, index, items.length]);
+  useEffect(() => {
+    if (testMode) return;
+    let cancelled = false;
+    (async () => {
+      try {
+        setLoading(true);
+        setError('');
+        const paths = await findNextCaches(cwd);
+        const sizes = await Promise.all(paths.map(p => getDirSize(p)));
+        if (cancelled) return;
+        const nextItems = [];
+        for (let i = 0; i < paths.length; i += 1) nextItems.push({
+          path: paths[i],
+          size: sizes[i]
+        });
+        setItems(nextItems);
+        // Reset UI focus/help after a fresh scan
+        setIndex(0);
+        setShowHelp(false);
+      } catch (error_) {
+        if (!cancelled) setError(String(error_?.message ?? error_));
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [cwd, testMode]);
+  useEffect(() => {
+    if (!confirmImmediately) return;
+    if (testMode) return;
+    if (items.length === 0) return;
+    setSelected(new Set(items.map((_, i) => i)));
+    setConfirm(true);
+  }, [confirmImmediately, items, testMode]);
+
+  // Auto-deselect deleted items
+  useEffect(() => {
+    setSelected(cur => {
+      const next = new Set();
+      for (const i of cur) {
+        if (items[i]?.status === 'deleted') {
+          continue;
+        }
+        next.add(i);
+      }
+      if (next.size === cur.size) {
+        return cur;
+      }
+      return next;
+    });
+  }, [items]);
+  return /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column",
+    padding: 1
+  }, /*#__PURE__*/React.createElement(Box, {
+    borderStyle: "round",
+    borderColor: "green",
+    padding: 1,
+    marginBottom: 1
+  }, /*#__PURE__*/React.createElement(Text, {
+    color: "green",
+    bold: true
+  }, "\uD83C\uDF3F Next Prune")), /*#__PURE__*/React.createElement(Box, {
+    borderStyle: "single",
+    borderColor: "gray",
+    padding: 1,
+    marginBottom: 1
+  }, /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column"
+  }, /*#__PURE__*/React.createElement(Box, null, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "Scan Directory:"), /*#__PURE__*/React.createElement(Text, null, " ", truncatedCwd)), /*#__PURE__*/React.createElement(Box, {
+    marginTop: 1,
+    flexDirection: "column"
+  }, packedScan.map((line, li) => /*#__PURE__*/React.createElement(Box, {
+    key: li
+  }, line.map((seg, si) => /*#__PURE__*/React.createElement(React.Fragment, {
+    key: si
+  }, /*#__PURE__*/React.createElement(Text, {
+    color: seg.label === 'Status:' ? 'blue' : 'yellow'
+  }, seg.label), /*#__PURE__*/React.createElement(Text, null, " ", seg.value), si < line.length - 1 && /*#__PURE__*/React.createElement(Text, null, " \u2022 ")))))))), error && /*#__PURE__*/React.createElement(Box, {
+    borderStyle: "single",
+    borderColor: error.startsWith('✅') ? 'green' : 'red',
+    padding: 1,
+    marginBottom: 1
+  }, error.startsWith('✅') ? /*#__PURE__*/React.createElement(Text, {
+    color: "green",
+    bold: true
+  }, error) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, {
+    color: "red",
+    bold: true
+  }, "\u274C Error:", ' '), /*#__PURE__*/React.createElement(Text, {
+    color: "red"
+  }, error))), /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column",
+    borderStyle: "single",
+    padding: 1,
+    height: listBoxHeight
+  }, items.length === 0 && !loading ? /*#__PURE__*/React.createElement(Box, {
+    justifyContent: "center",
+    alignItems: "center",
+    minHeight: 5
+  }, /*#__PURE__*/React.createElement(Text, {
+    color: "green"
+  }, "\u2705 No build artifacts found - your project is clean!")) : items.slice(viewStart, viewEnd).map((it, offset) => {
+    const i = viewStart + offset;
+    const rel = path.relative(cwd, it.path) || '.';
+    const isSel = selected.has(i);
+    const isFocus = i === index;
+    const prefix = isFocus ? '>' : ' ';
+    const mark = isSel ? '[x]' : '[ ]';
+    const sizeText = it.size === undefined || it.size === null ? '…' : human(it.size);
+    let statusColor = undefined;
+    let statusText = '';
+    if (it.status === 'deleted') {
+      // No inline indicator for deleted items; styling conveys state
+    } else if (it.status === 'error') {
+      statusColor = 'red';
+      statusText = ' ❌ error';
+    } else if (it.status === 'dry-run') {
+      statusColor = 'yellow';
+      statusText = ' 🔍 dry-run';
+    } else if (it.status === 'deleting') {
+      statusColor = 'blue';
+      statusText = ' 🗑️ deleting...';
+    }
+
+    // Ensure single-line rendering to avoid terminal scroll jumps
+    const containerWidth = Math.max(24, (cols || 80) - 6);
+    const leftPart = `${prefix} ${mark} ${sizeText.padStart(7)} `;
+    const reserved = leftPart.length + (statusText ? statusText.length : 0);
+    const maxRel = Math.max(3, containerWidth - reserved);
+    const displayRel = truncateMiddle(rel, maxRel);
+    return /*#__PURE__*/React.createElement(Box, {
+      key: it.path
+    }, /*#__PURE__*/React.createElement(Text, {
+      color: it.status === 'deleted' ? 'gray' : isFocus ? 'cyan' : undefined,
+      backgroundColor: isFocus && it.status !== 'deleted' ? 'blue' : undefined,
+      dimColor: it.status === 'deleted',
+      strikethrough: it.status === 'deleted'
+    }, leftPart, displayRel), statusText && /*#__PURE__*/React.createElement(Text, {
+      color: statusColor
+    }, statusText));
+  })), /*#__PURE__*/React.createElement(Box, {
+    borderStyle: "single",
+    borderColor: "gray",
+    padding: 1,
+    marginTop: 1
+  }, showHelp ? /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column"
+  }, /*#__PURE__*/React.createElement(Box, null, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan",
+    bold: true
+  }, "\uD83D\uDCD6 Help"), /*#__PURE__*/React.createElement(Text, null, " "), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, "(Esc to close)")), /*#__PURE__*/React.createElement(Box, null, /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column",
+    marginRight: 2
+  }, /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, "Navigation"), /*#__PURE__*/React.createElement(Text, null, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "\u2191\u2193"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " move \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "Home/End"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " jump \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "PgUp/PgDn"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " page")), /*#__PURE__*/React.createElement(Text, null), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, "Selection"), /*#__PURE__*/React.createElement(Text, null, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "Space"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " select \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "A"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " all \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "C"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " clear"))), /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column"
+  }, /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, "Actions"), /*#__PURE__*/React.createElement(Text, null, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "D/Enter"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " delete \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "R"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " rescan")), /*#__PURE__*/React.createElement(Text, null), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, "App"), /*#__PURE__*/React.createElement(Text, null, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "H/?"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " help \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, "Q"), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " quit"))))) : /*#__PURE__*/React.createElement(Box, {
+    flexDirection: "column"
+  }, packedLines.map((line, li) => /*#__PURE__*/React.createElement(Box, {
+    key: li
+  }, li === 0 && /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, "\uD83C\uDFAE "), line.map((seg, si) => /*#__PURE__*/React.createElement(React.Fragment, {
+    key: si
+  }, /*#__PURE__*/React.createElement(Text, {
+    color: "cyan"
+  }, seg.key), /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " ", seg.label), si < line.length - 1 && /*#__PURE__*/React.createElement(Text, {
+    dimColor: true
+  }, " \u2022 "))))))), confirm && /*#__PURE__*/React.createElement(Box, {
+    borderStyle: "double",
+    borderColor: "yellow",
+    padding: 1,
+    marginTop: 1
+  }, /*#__PURE__*/React.createElement(Text, {
+    color: "yellow",
+    bold: true
+  }, "\u26A0\uFE0F Confirm Deletion"), /*#__PURE__*/React.createElement(Text, null, "Delete ", selected.size, " directories (", human(selectedSize), ")", dryRun ? ' [dry-run mode]' : '', "?"), /*#__PURE__*/React.createElement(Box, {
+    marginTop: 1
+  }, /*#__PURE__*/React.createElement(Text, {
+    color: "green",
+    bold: true
+  }, "[Y]es"), /*#__PURE__*/React.createElement(Text, null, " \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "red",
+    bold: true
+  }, "[N]o"), /*#__PURE__*/React.createElement(Text, null, " \u2022 "), /*#__PURE__*/React.createElement(Text, {
+    color: "gray",
+    bold: true
+  }, "Esc"), /*#__PURE__*/React.createElement(Text, {
+    color: "gray"
+  }, " cancel"))));
+}

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import path from 'node:path';
+import meow from 'meow';
+import { scanWithSizes, human } from './scanner.js';
+const cli = meow(`
+	Usage
+	  $ next-prune [options]
+
+	Description
+	  Scan for Next.js build artifacts (.next, out), Vercel outputs (.vercel/output), 
+	  Turborepo caches (.turbo), and other safe-to-delete directories.
+
+	Options
+	  --yes, -y     Skip confirmation and delete selected immediately
+	  --dry-run      Don't delete anything; just show results
+	  --cwd=<path>   Directory to scan (default: current working dir)
+	  --list         Non-interactive list of artifacts and sizes, then exit
+	  --json         Output JSON (implies --list)
+
+	Examples
+	  $ next-prune
+	  $ next-prune --dry-run
+	  $ next-prune -y --cwd=./packages
+	`, {
+  importMeta: import.meta,
+  flags: {
+    yes: {
+      type: 'boolean',
+      shortFlag: 'y',
+      default: false
+    },
+    dryRun: {
+      type: 'boolean',
+      default: false
+    },
+    cwd: {
+      type: 'string'
+    },
+    list: {
+      type: 'boolean',
+      default: false
+    },
+    json: {
+      type: 'boolean',
+      default: false
+    }
+  }
+});
+const props = {
+  confirmImmediately: Boolean(cli.flags.yes),
+  dryRun: Boolean(cli.flags.dryRun),
+  cwd: cli.flags.cwd ?? process.cwd()
+};
+async function main() {
+  if (cli.flags.list || cli.flags.json) {
+    const items = await scanWithSizes(props.cwd);
+    if (cli.flags.json) {
+      process.stdout.write(JSON.stringify(items, null, 2) + '\n');
+      return;
+    }
+    let total = 0;
+    for (const it of items) total += typeof it.size === 'number' ? it.size : 0;
+    for (const it of items) {
+      const rel = path.relative(props.cwd, it.path) || '.';
+      process.stdout.write(`${human(it.size).padStart(6)}  ${rel}\n`);
+    }
+    process.stdout.write(`\nTotal: ${human(total)} in ${items.length} directorie${items.length === 1 ? '' : 's'}\n`);
+    return;
+  }
+  const reactModule = await import('react');
+  const React = reactModule.default;
+  const ink = await import('ink');
+  const {
+    render
+  } = ink;
+  const {
+    default: App
+  } = await import('./app.js');
+  render(React.createElement(App, props));
+}
+
+// eslint-disable-next-line unicorn/prefer-top-level-await
+main();

package/dist/scanner.js

@@ -0,0 +1,125 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+export const FRAMES = Object.freeze(['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']);
+
+// Patterns for Next.js and related build artifacts/caches
+const CACHE_PATTERNS = ['.next',
+// Next.js build output and cache
+'out',
+// Next.js static export output
+'.vercel/output',
+// Vercel Build Output API bundle
+'.turbo',
+// Turborepo cache
+'.vercel_build_output',
+// Legacy Vercel build output
+'node_modules/.cache/next' // Next.js cache in node_modules
+];
+const SKIP_DIRS = new Set(['.git', 'node_modules', 'dist', 'build', 'coverage', ...CACHE_PATTERNS]);
+export const human = bytes => {
+  if (!bytes) return '0 B';
+  const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  const value = bytes / 1024 ** i;
+  return `${value.toFixed(value >= 10 || i === 0 ? 0 : 1)} ${units[i]}`;
+};
+export const dirExists = async p => {
+  try {
+    const s = await fs.stat(p);
+    return s.isDirectory();
+  } catch {
+    return false;
+  }
+};
+export async function* walk(root) {
+  let entries = [];
+  try {
+    entries = await fs.readdir(root, {
+      withFileTypes: true
+    });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const full = path.join(root, entry.name);
+    yield full;
+    if (SKIP_DIRS.has(entry.name)) continue;
+    yield* walk(full);
+  }
+}
+export const findNextCaches = async cwd => {
+  const results = [];
+
+  // Check for build artifacts in the root directory
+  for (const pattern of CACHE_PATTERNS) {
+    const fullPath = path.join(cwd, pattern);
+    if (await dirExists(fullPath)) {
+      results.push(fullPath);
+    }
+  }
+
+  // Walk subdirectories to find nested artifacts
+  for await (const dir of walk(cwd)) {
+    const base = path.basename(dir);
+    const relativePath = path.relative(cwd, dir);
+
+    // Check if this directory matches any of our patterns
+    if (CACHE_PATTERNS.includes(base)) {
+      results.push(dir);
+      continue;
+    }
+
+    // Special handling for nested patterns like .vercel/output
+    for (const pattern of CACHE_PATTERNS) {
+      if (pattern.includes('/') && relativePath === pattern) {
+        results.push(dir);
+        break;
+      }
+    }
+
+    // Special case for node_modules/.cache/next
+    if (base === 'node_modules') {
+      const maybe = path.join(dir, '.cache', 'next');
+      if (await dirExists(maybe)) results.push(maybe);
+    }
+  }
+  return [...new Set(results)];
+};
+export const getDirSize = async dir => {
+  let total = 0;
+  const processDir = async d => {
+    let entries = [];
+    try {
+      entries = await fs.readdir(d, {
+        withFileTypes: true
+      });
+    } catch {
+      return 0;
+    }
+    const paths = entries.map(entry => path.join(d, entry.name));
+    const stats = await Promise.all(paths.map(p => fs.lstat(p).catch(() => undefined)));
+    let sizeHere = 0;
+    const subdirs = [];
+    for (const [i, st] of stats.entries()) {
+      if (!st) continue;
+      if (st.isSymbolicLink()) continue;
+      if (st.isDirectory()) subdirs.push(paths[i]);else sizeHere += st.size;
+    }
+    const subSizes = await Promise.all(subdirs.map(d2 => processDir(d2)));
+    for (const s of subSizes) sizeHere += s;
+    return sizeHere;
+  };
+  total = await processDir(dir);
+  return total;
+};
+export const scanWithSizes = async cwd => {
+  const paths = await findNextCaches(cwd);
+  const sizes = await Promise.all(paths.map(p => getDirSize(p)));
+  const items = [];
+  for (let i = 0; i < paths.length; i += 1) items.push({
+    path: paths[i],
+    size: sizes[i]
+  });
+  return items;
+};

package/package.json

@@ -0,0 +1,99 @@
+{
+	"name": "next-prune",
+	"version": "1.0.0",
+	"description": "Interactive terminal UI to prune Next.js build artifacts and caches to free disk space",
+	"license": "MIT",
+	"author": "next-prune contributors",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/khoa-lucents/next-prune.git"
+	},
+	"bugs": {
+		"url": "https://github.com/khoa-lucents/next-prune/issues"
+	},
+	"homepage": "https://github.com/khoa-lucents/next-prune#readme",
+	"keywords": [
+		"nextjs",
+		"next",
+		"prune",
+		"build",
+		"artifacts",
+		"cache",
+		"vercel",
+		"turbo",
+		"clean",
+		"cli",
+		"terminal",
+		"ui",
+		"ink",
+		"disk-space",
+		"webpack-cache"
+	],
+	"bin": {
+		"next-prune": "dist/cli.js"
+	},
+	"type": "module",
+	"engines": {
+		"node": ">=16"
+	},
+	"scripts": {
+		"build": "babel --out-dir=dist source",
+		"dev": "babel --out-dir=dist --watch source",
+		"test": "prettier --check . && xo && ava",
+		"prepublishOnly": "npm run build && npm test"
+	},
+	"files": [
+		"dist"
+	],
+	"dependencies": {
+		"ink": "^4.1.0",
+		"meow": "^11.0.0",
+		"react": "^18.2.0"
+	},
+	"devDependencies": {
+		"@babel/cli": "^7.21.0",
+		"@babel/preset-react": "^7.18.6",
+		"@vdemedes/prettier-config": "^2.0.1",
+		"ava": "^5.2.0",
+		"chalk": "^5.2.0",
+		"eslint-config-xo-react": "^0.27.0",
+		"eslint-plugin-react": "^7.32.2",
+		"eslint-plugin-react-hooks": "^4.6.0",
+		"import-jsx": "^5.0.0",
+		"ink-testing-library": "^3.0.0",
+		"prettier": "^2.8.7",
+		"xo": "^0.53.1"
+	},
+	"ava": {
+		"environmentVariables": {
+			"NODE_NO_WARNINGS": "1"
+		},
+		"nodeArguments": [
+			"--loader=import-jsx"
+		]
+	},
+	"xo": {
+		"extends": "xo-react",
+		"prettier": true,
+		"rules": {
+			"react/prop-types": "off",
+			"unicorn/expiring-todo-comments": "off",
+			"complexity": "off",
+			"unicorn/prevent-abbreviations": "off",
+			"capitalized-comments": "off",
+			"padding-line-between-statements": "off",
+			"no-await-in-loop": "off",
+			"react/jsx-sort-props": "off",
+			"react/no-array-index-key": "off",
+			"no-undef-init": "off",
+			"unicorn/prefer-switch": "off",
+			"react/self-closing-comp": "off"
+		}
+	},
+	"prettier": "@vdemedes/prettier-config",
+	"babel": {
+		"presets": [
+			"@babel/preset-react"
+		]
+	}
+}

package/readme.md

@@ -0,0 +1,85 @@
+# Next Prune 🌿
+
+> Prune Next.js build artifacts and caches from your terminal. Interactive TUI to scan and delete `.next`, `out`, `.vercel/output`, `.turbo`, and other safe-to-delete directories to free disk space.
+
+[![npm version](https://img.shields.io/npm/v/next-prune.svg)](https://www.npmjs.com/package/next-prune)
+[![CI](https://github.com/OWNER/next-prune/actions/workflows/ci.yml/badge.svg)](https://github.com/OWNER/next-prune/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/next-prune.svg)](https://nodejs.org/)
+
+## What Gets Pruned
+
+**Safe to delete (recreated by tools):**
+
+- `.next/` - Next.js build output and cache
+- `out/` - Next.js static export output
+- `.vercel/output/` - Vercel Build Output API bundle
+- `.turbo/` - Turborepo cache (default at `.turbo/cache`)
+- `.vercel_build_output/` - Legacy Vercel build output
+- `node_modules/.cache/next` - Next.js cache in node_modules
+
+**Always preserved:**
+
+- `.vercel/project.json` - Keeps local folder linked to Vercel project
+- `vercel.json` - Vercel project configuration
+- `next.config.*` - Next.js configuration
+- All source code and project files
+
+**Features:**
+
+- 🎯 Interactive terminal UI built with [Ink](https://github.com/vadimdemedes/ink)
+- 🔍 Scans recursively for Next.js, Vercel, and Turborepo build artifacts
+- 📊 Shows disk usage for each directory found
+- ✅ Select multiple directories for batch deletion
+- 🚀 Non-interactive modes for scripting (`--list`, `--json`)
+- 🛡️ Safe deletion with confirmation prompts
+
+## Install
+
+```bash
+$ npm install --global next-prune
+```
+
+## CLI
+
+````
+
+$ next-prune --help
+
+  Usage
+    $ next-prune
+
+  Options
+    --yes, -y      Skip confirmation and delete selected immediately
+    --dry-run       Don't delete anything; just show results
+    --cwd=<path>    Directory to scan (default: current working dir)
+    --list          Non-interactive list of artifacts and sizes, then exit
+    --json          Output JSON (implies --list)
+
+  Examples
+    $ next-prune                # interactive TUI
+    $ next-prune --dry-run      # scan only
+    $ next-prune --list         # list found artifacts
+    $ next-prune --json         # machine-readable output
+    $ next-prune --yes          # one-shot cleanup
+
+## One-Shot Cleanup
+
+For quick cleanup without interaction:
+
+```bash
+# Equivalent to: rm -rf .next out .vercel/output .turbo
+$ next-prune --yes
+````
+
+## Contributing
+
+See `CONTRIBUTING.md` and `AGENTS.md`. By participating, you agree to our `CODE_OF_CONDUCT.md`.
+
+## License
+
+MIT © next-prune contributors
+
+```
+
+```