@doccy/fell 0.1.0 → 0.1.2

package/README.md

@@ -1,12 +1,11 @@
 ```
-   ▄▀▀         ▀▀█    ▀▀█   
- ▄▄█▄▄   ▄▄▄     █      █   
-   █    █▀  █    █      █   
-   █    █▀▀▀▀    █      █   
-   █    ▀█▄▄▀    ▀▄▄    ▀▄▄                             
+▗▞▀▀▘▗▞▀▚▖█ █ 
+▐▌   ▐▛▀▀▘█ █ 
+▐▛▀▘ ▝▚▄▄▖█ █ 
+▐▌        █ █                         
 ```
 
-*"To fell a tree."* 
+> *"To fell a tree."* 
 
 `fell` is a CLI tool that help's you actively manage, prune and delete worktrees.
 
@@ -64,7 +63,7 @@ q / ctrl+c        Quit
 
 ### Preview
 
-<img src="./docs/header-img.png" height="300px">
+<img src="./docs/fell-demo.gif" alt="fell demo" height="400px">
 
 ## License
 

package/cli.ts

@@ -22,12 +22,15 @@ import {
   fetchPrForBranch,
   fetchWorktreeFileStatus,
   fetchWorktreeFileList,
+  fetchDirectorySize,
+  formatBytes,
   openDirectory,
   checkGhStatus,
   type Worktree,
   type PrStatus,
   type FileStatusResult,
   type FileEntry,
+  type DirSize,
   type GhDiagnostic,
 } from "./lib/git"
 import {
@@ -41,6 +44,7 @@ import {
   shortenPath,
   formatPrStatus,
   formatFileStatus,
+  fellLogo,
   renderHelpLines,
   printCliHelp,
   type Key,
@@ -54,6 +58,7 @@ interface WorktreeItem {
   worktree: Worktree
   prStatus: PrStatus
   fileStatus: FileStatusResult
+  dirSize: DirSize
 }
 
 /** Per-item progress entry for the deleting status line. */
@@ -157,7 +162,23 @@ function renderRow(
   // Pad branch column for alignment
   const branchPadded = pad(branchStr, BRANCH_COL + 2)
 
-  const mainLine = `  ${cursor} ${check} ${branchPadded}${sha}   ${pr}${tagStr}`
+  // Directory size column
+  let sizeStr: string
+  switch (item.dirSize.type) {
+    case "loading": {
+      const frame = SPINNER_FRAMES[state.spinnerFrame % SPINNER_FRAMES.length]
+      sizeStr = c.dim(`${frame} estimating`)
+      break
+    }
+    case "done":
+      sizeStr = c.dim(formatBytes(item.dirSize.bytes))
+      break
+    case "error":
+      sizeStr = ""
+      break
+  }
+
+  const mainLine = `  ${cursor} ${check} ${branchPadded}${sha}   ${pad(pr, 18)}${sizeStr}${tagStr}`
   const lines = [mainLine]
 
   // Sub-line: dirty file status with warning icon, indented under the branch name
@@ -203,12 +224,11 @@ function render(state: State): void {
 
   // Title bar
   lines.push("")
-  const selectedInfo =
+  const suffix =
     state.selected.size > 0
       ? `  ${c.lime(`${state.selected.size} selected`)}`
-      : `    ${c.dim(c.italic("worktree cli"))}`
-  lines.push(`  ${c.dim("▐▘ █▌ ▐  ▐")}${selectedInfo}`)
-  lines.push(`  ${c.dim("▜▘ ▙▖ ▐▖ ▐▖")}`)
+      : ""
+  lines.push(`  ${c.bold(fellLogo())}  ${c.dim("Interactive Worktree Cleanup")}${suffix}`)
   lines.push("")
 
   // Main worktree (always visible, non-interactive)
@@ -471,6 +491,7 @@ function startDelete(
     await refreshWorktrees(state)
     startPrFetching(state, rerender)
     startFileStatusFetching(state, rerender)
+    startSizeFetching(state, rerender)
 
     if (needsForce) {
       state.mode = {
@@ -503,6 +524,7 @@ async function refreshWorktrees(state: State): Promise<void> {
       worktree: w,
       prStatus: { type: "loading" as const },
       fileStatus: { type: "loading" as const },
+      dirSize: { type: "loading" as const },
     }))
 
   state.selected.clear()
@@ -642,6 +664,35 @@ function startFileStatusFetching(state: State, rerender: () => void): void {
   })()
 }
 
+// ---------------------------------------------------------------------------
+// Async directory size fetching (background, sequential)
+// ---------------------------------------------------------------------------
+
+/**
+ * Fetch directory sizes for all non-main worktrees in background.
+ * Runs sequentially (du is I/O heavy, parallel would thrash disk).
+ */
+function startSizeFetching(state: State, rerender: () => void): void {
+  ;(async () => {
+    for (let i = 0; i < state.items.length; i++) {
+      const item = state.items[i]
+      const path = item.worktree.path
+      try {
+        const result = await fetchDirectorySize(path)
+        // Guard against stale index
+        if (state.items[i]?.worktree.path === path) {
+          state.items[i].dirSize = result
+        }
+      } catch {
+        if (state.items[i]?.worktree.path === path) {
+          state.items[i].dirSize = { type: "error" }
+        }
+      }
+      rerender()
+    }
+  })()
+}
+
 // ---------------------------------------------------------------------------
 // Key handling
 // ---------------------------------------------------------------------------
@@ -742,6 +793,7 @@ async function handleBrowseKey(state: State, key: Key): Promise<void> {
     await refreshWorktrees(state)
     startPrFetching(state, () => render(state))
     startFileStatusFetching(state, () => render(state))
+    startSizeFetching(state, () => render(state))
     state.message = { text: "Refreshed.", kind: "success" }
     return
   }
@@ -848,6 +900,7 @@ async function handleConfirmPruneKey(state: State, key: Key): Promise<void> {
       await refreshWorktrees(state)
       startPrFetching(state, () => render(state))
       startFileStatusFetching(state, () => render(state))
+      startSizeFetching(state, () => render(state))
       state.mode = {
         type: "result",
         lines: [`${c.green("\u2713")} Stale references pruned.`],
@@ -877,8 +930,7 @@ async function printListAndExit(): Promise<void> {
   const ghDiagnostic = await checkGhStatus()
 
   console.log()
-  console.log(`  ${c.dim("▐▘ █▌ ▐  ▐")}  ${c.dim("--list")}`)
-  console.log(`  ${c.dim("▜▘ ▙▖ ▐▖ ▐▖")}`)
+  console.log(`  ${c.bold(fellLogo())}  ${c.dim("--list")}`)
   console.log()
 
   // Fetch file statuses for all worktrees concurrently
@@ -972,7 +1024,9 @@ function startSpinnerTimer(
 ): ReturnType<typeof setInterval> {
   return setInterval(() => {
     // Animate when there are loading statuses or an active delete in progress
-    const hasLoading = state.items.some((i) => i.prStatus.type === "loading")
+    const hasLoading = state.items.some(
+      (i) => i.prStatus.type === "loading" || i.dirSize.type === "loading",
+    )
     const isDeleting = state.mode.type === "deleting"
     if (hasLoading || isDeleting) {
       state.spinnerFrame =
@@ -1030,6 +1084,7 @@ async function main() {
       worktree: w,
       prStatus: { type: "loading" },
       fileStatus: { type: "loading" },
+      dirSize: { type: "loading" },
     })),
     mainWorktree,
     cursor: 0,
@@ -1079,9 +1134,10 @@ async function main() {
     // Initial render
     render(state)
 
-    // Start background PR fetching + file status checks
+    // Start background PR fetching, file status checks, and size estimation
     startPrFetching(state, () => render(state))
     startFileStatusFetching(state, () => render(state))
+    startSizeFetching(state, () => render(state))
 
     // Start spinner animation timer
     const spinnerTimer = startSpinnerTimer(state, () => render(state))

package/lib/git.ts

@@ -238,6 +238,45 @@ export async function fetchWorktreeFileStatus(
   }
 }
 
+// ---------------------------------------------------------------------------
+// Directory size
+// ---------------------------------------------------------------------------
+
+export type DirSize =
+  | { type: "loading" }
+  | { type: "done"; bytes: number }
+  | { type: "error" }
+
+/**
+ * Get the total size of a directory using `du -sk`.
+ * Returns size in bytes. Uses -sk (kilobytes, no follow symlinks)
+ * to keep it fast -- avoids traversing linked node_modules twice.
+ */
+export async function fetchDirectorySize(
+  dirPath: string,
+): Promise<DirSize> {
+  const result = await $`du -sk ${dirPath}`.nothrow().quiet()
+  if (result.exitCode !== 0) return { type: "error" }
+
+  const kb = parseInt(result.stdout.toString().split("\t")[0], 10)
+  if (isNaN(kb)) return { type: "error" }
+
+  return { type: "done", bytes: kb * 1024 }
+}
+
+/** Format bytes into a human-readable string (e.g. "9.4 GB", "29 MB"). */
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(0)} KB`
+  if (bytes < 1024 * 1024 * 1024)
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`
+}
+
+// ---------------------------------------------------------------------------
+// File list (per-worktree)
+// ---------------------------------------------------------------------------
+
 /** A single file entry from git status with its change type. */
 export interface FileEntry {
   path: string

package/lib/tui.ts

@@ -29,6 +29,34 @@ export const c = {
   lime: (s: string) => `${CSI}38;5;154m${s}${CSI}0m`,
 } as const
 
+/**
+ * Apply a linear gradient across a string using 256-colour ANSI.
+ * Each character gets an interpolated colour between the start and end RGB values.
+ */
+export function gradient(
+  s: string,
+  from: [number, number, number],
+  to: [number, number, number],
+): string {
+  const len = s.length
+  if (len === 0) return s
+  return s
+    .split("")
+    .map((ch, i) => {
+      const t = len === 1 ? 0 : i / (len - 1)
+      const r = Math.round(from[0] + (to[0] - from[0]) * t)
+      const g = Math.round(from[1] + (to[1] - from[1]) * t)
+      const b = Math.round(from[2] + (to[2] - from[2]) * t)
+      return `${CSI}38;2;${r};${g};${b}m${ch}`
+    })
+    .join("") + `${CSI}0m`
+}
+
+/** Pre-built gradient for the "fell" brand text. Cyan -> lime. */
+export function fellLogo(): string {
+  return gradient("fell", [80, 200, 255], [160, 230, 80])
+}
+
 export const SPINNER_FRAMES = [
   "\u28CB", "\u28D9", "\u28F9", "\u28F8", "\u28FC", "\u28F4",
   "\u28E6", "\u28E7", "\u28C7", "\u28CF",
@@ -251,8 +279,7 @@ export function renderHelpLines(): string[] {
 
 export function printCliHelp(): void {
   console.log()
-  console.log(`  ${c.dim("▐▘ █▌ ▐  ▐")}  ${c.dim("Interactive git worktree manager")}`)
-  console.log(`  ${c.dim("▜▘ ▙▖ ▐▖ ▐▖")}`)
+  console.log(`  ${c.bold(fellLogo())}  ${c.dim("Interactive Worktree Cleanup")}`)
   console.log()
   console.log(c.yellow("  USAGE"))
   console.log()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccy/fell",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Interactive git worktree manager. Navigate, inspect, delete, and prune worktrees with async PR status fetching.",
   "license": "MIT",
   "bin": {