@kud/claude-sessions-cli 1.0.0

package/README.md

@@ -0,0 +1,108 @@
+# claude-sessions
+
+<p align="center">
+  <b>TUI session manager for Claude Code</b><br/>
+  Browse, open, create, and clean up your Claude sessions from a single interactive interface.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@kud/claude-sessions-cli"><img alt="npm version" src="https://img.shields.io/npm/v/%40kud%2Fclaude-sessions-cli?color=brightgreen" /></a>
+  <a href="https://www.npmjs.com/package/@kud/claude-sessions-cli"><img alt="downloads" src="https://img.shields.io/npm/dm/%40kud%2Fclaude-sessions-cli" /></a>
+  <a href="LICENSE"><img alt="license" src="https://img.shields.io/npm/l/%40kud%2Fclaude-sessions-cli" /></a>
+  <a href="https://nodejs.org"><img alt="node version" src="https://img.shields.io/node/v/%40kud%2Fclaude-sessions-cli" /></a>
+</p>
+
+> TL;DR: Run `claude-sessions`, pick a session, press `enter`. Claude Code opens right where you left off.
+
+---
+
+## Table of Contents
+
+- [Why](#why)
+- [Features](#features)
+- [Install](#install)
+- [Usage](#usage)
+- [Key Bindings](#key-bindings)
+- [Clean Mode](#clean-mode)
+- [Requirements](#requirements)
+
+## Why
+
+Claude Code stores sessions per directory but gives you no way to navigate them. This tool:
+
+- Lists all your sessions (chat + code) sorted by last activity
+- Lets you jump straight back into any session with `enter`
+- Separates chat sessions (`~/.chats/`) from code sessions (project dirs)
+- Keeps your session data clean with an interactive cleanup mode
+
+## Features
+
+| Category   | Highlights                                                          |
+| ---------- | ------------------------------------------------------------------- |
+| Navigation | Sorted by last activity, grouped by type (chat / code)              |
+| Search     | Fuzzy filter by name or path with `/`                               |
+| Filter     | Toggle between all / chat / code views with `tab`                   |
+| New chat   | Create a named chat session and open it immediately                 |
+| Delete     | Remove a session's history and directory with confirmation          |
+| Clean mode | Interactive cleanup of ghost entries, stale pointers, orphaned dirs |
+
+## Install
+
+```sh
+npm install -g @kud/claude-sessions-cli
+```
+
+## Usage
+
+```sh
+claude-sessions         # open the TUI
+claude-sessions clean   # clean up stale session data
+```
+
+### TUI
+
+```
+/ search…
+
+  + New chat
+
+── chat ────────────────────────
+▶ 󰭹  Hey         ~/.chats/hey           just now
+  󰭹  Planning    ~/.chats/planning      2h
+
+── code ────────────────────────
+  󰏗  my-project  ~/Projects/my-project  yesterday
+  󰏗  api         ~/Projects/api         3d
+
+↑↓ nav  enter open  d remove  / search  tab filter  C clean  q quit   [all] chat code
+```
+
+## Key Bindings
+
+| Key         | Action                             |
+| ----------- | ---------------------------------- |
+| `↑` `↓`     | Navigate                           |
+| `enter`     | Open session in Claude Code        |
+| `d`         | Remove session (with confirmation) |
+| `/`         | Search by name or path             |
+| `tab`       | Cycle filter: all → chat → code    |
+| `C`         | Open clean mode                    |
+| `q` / `esc` | Quit                               |
+
+## Clean Mode
+
+Scans `~/.claude.json` and `~/.claude/projects/` for stale data. Issues are grouped by type — select which categories to clean before confirming. Nothing is deleted without confirmation.
+
+| Type             | Meaning                                                                  | Action                       |
+| ---------------- | ------------------------------------------------------------------------ | ---------------------------- |
+| ghost            | Entry in `~/.claude.json` but the project directory no longer exists     | Remove from `~/.claude.json` |
+| no history       | Entry in `~/.claude.json` with no conversation history                   | Remove from `~/.claude.json` |
+| orphaned history | History in `~/.claude/projects/` with no matching `~/.claude.json` entry | Trash the history folder     |
+
+Available as both a TUI mode (`C` key) and a standalone subcommand (`claude-sessions clean`).
+
+## Requirements
+
+- Node.js ≥ 24
+- [Claude Code](https://claude.ai/code) installed (`claude` in `PATH`)
+- [`trash`](https://github.com/sindresorhus/trash-cli) for safe deletes (`npm install -g trash-cli`)

package/dist/index.js

@@ -0,0 +1,577 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/index.tsx
+import React, { useState, useEffect } from "react";
+import { render, Box, Text, useInput, useApp } from "ink";
+import TextInput from "ink-text-input";
+import { readdir, stat } from "fs/promises";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { spawnSync, execSync } from "child_process";
+import { homedir } from "os";
+import { jsx, jsxs } from "react/jsx-runtime";
+var HOME = homedir();
+var CLAUDE_PROJECTS = join(HOME, ".claude", "projects");
+var CLAUDE_JSON = join(HOME, ".claude.json");
+var CHATS_DIR = join(HOME, ".chats");
+var ICON_CHAT = "\u{F0B79}";
+var ICON_CODE = "\uF121";
+var pendingAction = null;
+var slugify = (name) => name.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+var humanLabel = (dir) => {
+  const base = dir.split("/").pop() || dir;
+  const words = base.replace(/^[._-]+/, "").replace(/[-_]+/g, " ").trim();
+  return (words || base).replace(/\b\w/g, (c) => c.toUpperCase());
+};
+var kebabLabel = (dir) => dir.split("/").pop() || dir;
+var timeAgo = (mtime) => {
+  const diff = Date.now() / 1e3 - mtime;
+  const m = Math.floor(diff / 60);
+  const h = Math.floor(diff / 3600);
+  const d = Math.floor(diff / 86400);
+  if (m < 1) return "just now";
+  if (m < 60) return `${m}m`;
+  if (h < 24) return `${h}h`;
+  if (d === 1) return "yesterday";
+  if (d < 7) return `${d}d`;
+  return new Date(mtime * 1e3).toLocaleDateString("en-GB", {
+    day: "2-digit",
+    month: "short"
+  });
+};
+var removeFromClaudeJson = (dir) => {
+  try {
+    const json = JSON.parse(readFileSync(CLAUDE_JSON, "utf8"));
+    if (json.projects?.[dir]) {
+      delete json.projects[dir];
+      writeFileSync(CLAUDE_JSON, JSON.stringify(json, null, 2));
+    }
+  } catch {
+  }
+};
+var toProjectDirName = (absPath) => absPath.replace(/[^a-zA-Z0-9]/g, "-");
+var loadSessions = async () => {
+  const sessions = [];
+  if (existsSync(CLAUDE_JSON)) {
+    try {
+      const projectPaths = Object.keys(
+        JSON.parse(readFileSync(CLAUDE_JSON, "utf8")).projects ?? {}
+      );
+      await Promise.all(
+        projectPaths.map(async (cwd) => {
+          try {
+            const claudeProjectDir = join(
+              CLAUDE_PROJECTS,
+              toProjectDirName(cwd)
+            );
+            if (!existsSync(claudeProjectDir)) return;
+            const jsonlFiles = (await readdir(claudeProjectDir)).filter(
+              (f) => f.endsWith(".jsonl")
+            );
+            if (!jsonlFiles.length) return;
+            const mtime = Math.max(
+              ...await Promise.all(
+                jsonlFiles.map(
+                  (f) => stat(join(claudeProjectDir, f)).then((s) => s.mtimeMs / 1e3)
+                )
+              )
+            );
+            const shortPath = cwd.replace(HOME, "~");
+            const type = cwd === HOME || cwd.startsWith(CHATS_DIR) ? "chat" : "code";
+            sessions.push({
+              dir: cwd,
+              label: type === "chat" ? humanLabel(cwd) : kebabLabel(cwd),
+              path: shortPath,
+              type,
+              mtime,
+              ago: timeAgo(mtime),
+              claudeProjectDir
+            });
+          } catch {
+          }
+        })
+      );
+    } catch {
+    }
+  }
+  const seen = new Set(sessions.map((s) => s.dir));
+  if (existsSync(CHATS_DIR)) {
+    try {
+      for (const dir of await readdir(CHATS_DIR)) {
+        try {
+          const fullPath = join(CHATS_DIR, dir);
+          if (!(await stat(fullPath)).isDirectory() || seen.has(fullPath))
+            continue;
+          const shortPath = fullPath.replace(HOME, "~");
+          sessions.push({
+            dir: fullPath,
+            label: humanLabel(fullPath),
+            path: shortPath,
+            type: "chat",
+            mtime: 0,
+            ago: "new",
+            claudeProjectDir: ""
+          });
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  const unique = [...new Map(sessions.map((s) => [s.dir, s])).values()];
+  return unique.sort((a, b) => b.mtime - a.mtime);
+};
+var findCleanItems = async () => {
+  const items = [];
+  if (!existsSync(CLAUDE_JSON)) return items;
+  let projects = {};
+  try {
+    projects = JSON.parse(readFileSync(CLAUDE_JSON, "utf8")).projects ?? {};
+  } catch {
+    return items;
+  }
+  const projectPaths = Object.keys(projects);
+  for (const cwd of projectPaths) {
+    const projectDir = join(CLAUDE_PROJECTS, toProjectDirName(cwd));
+    const shortCwd = cwd.replace(HOME, "~");
+    if (!existsSync(cwd)) {
+      items.push({
+        label: shortCwd,
+        reason: "ghost (directory deleted)",
+        execute: () => {
+          removeFromClaudeJson(cwd);
+          if (existsSync(projectDir)) execSync(`trash "${projectDir}"`);
+        }
+      });
+      continue;
+    }
+    if (!existsSync(projectDir)) {
+      items.push({
+        label: shortCwd,
+        reason: "no history",
+        execute: () => removeFromClaudeJson(cwd)
+      });
+      continue;
+    }
+    try {
+      const jsonlFiles = (await readdir(projectDir)).filter(
+        (f) => f.endsWith(".jsonl")
+      );
+      if (!jsonlFiles.length)
+        items.push({
+          label: shortCwd,
+          reason: "no history",
+          execute: () => {
+            removeFromClaudeJson(cwd);
+            execSync(`trash "${projectDir}"`);
+          }
+        });
+    } catch {
+    }
+  }
+  if (existsSync(CLAUDE_PROJECTS)) {
+    const knownDirNames = new Set(projectPaths.map(toProjectDirName));
+    try {
+      for (const dir of await readdir(CLAUDE_PROJECTS)) {
+        if (!knownDirNames.has(dir)) {
+          const fullPath = join(CLAUDE_PROJECTS, dir);
+          items.push({
+            label: `~/.claude/projects/${dir}`,
+            reason: "orphaned history",
+            execute: () => execSync(`trash "${fullPath}"`)
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  return items;
+};
+var deleteSession = (item) => {
+  if (item.claudeProjectDir) {
+    try {
+      execSync(`trash "${item.claudeProjectDir}"`);
+    } catch {
+    }
+    removeFromClaudeJson(item.dir);
+  }
+  if (item.type === "chat") {
+    try {
+      execSync(`trash "${item.dir}"`);
+    } catch {
+    }
+  }
+};
+var SectionHeader = ({ label }) => {
+  return /* @__PURE__ */ jsx(Box, { paddingX: 2, marginTop: 1, children: /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+    "\u2500\u2500 ",
+    label,
+    " \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+  ] }) });
+};
+var Hint = ({ pairs }) => /* @__PURE__ */ jsx(Box, { gap: 2, children: pairs.map(([key, desc]) => /* @__PURE__ */ jsxs(Box, { gap: 1, children: [
+  /* @__PURE__ */ jsx(Text, { color: "white", children: key }),
+  /* @__PURE__ */ jsx(Text, { dimColor: true, children: desc })
+] }, key)) });
+var FilterBar = ({ filter }) => {
+  const opts = ["all", "chat", "code"];
+  return /* @__PURE__ */ jsx(Box, { gap: 1, children: opts.map((o) => /* @__PURE__ */ jsx(
+    Text,
+    {
+      color: filter === o ? "cyan" : "gray",
+      bold: filter === o,
+      children: filter === o ? `[${o}]` : o
+    },
+    o
+  )) });
+};
+var CleanConfirm = ({
+  items,
+  onConfirm,
+  onCancel
+}) => {
+  const groups = items ? [...new Map(items.map((item) => [item.reason, item.reason])).keys()] : [];
+  const [cursor, setCursor] = useState(0);
+  const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
+  useEffect(() => {
+    if (groups.length) setSelected(new Set(groups));
+  }, [items]);
+  useInput(
+    (input, key) => {
+      if (!items) return;
+      if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
+      if (key.downArrow) setCursor((c) => Math.min(groups.length - 1, c + 1));
+      if (input === " ")
+        setSelected((s) => {
+          const next = new Set(s);
+          const reason = groups[cursor];
+          if (next.has(reason)) next.delete(reason);
+          else next.add(reason);
+          return next;
+        });
+      if (input === "a")
+        setSelected(
+          (s) => s.size === groups.length ? /* @__PURE__ */ new Set() : new Set(groups)
+        );
+      if (input === "y")
+        onConfirm(items.filter((item) => selected.has(item.reason)));
+      if (input === "n" || key.escape) onCancel();
+    },
+    { isActive: !!items }
+  );
+  if (!items) return /* @__PURE__ */ jsx(Text, { dimColor: true, children: " scanning\u2026" });
+  if (!items.length)
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx(Text, { color: "green", children: " nothing to clean" }),
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Hint, { pairs: [["esc", "back"]] }) })
+    ] });
+  const REASON_COLOR = {
+    "ghost (directory deleted)": "red",
+    "no history": "yellow",
+    "orphaned history": "magenta"
+  };
+  const countByReason = items.reduce((acc, item) => {
+    acc[item.reason] = (acc[item.reason] ?? 0) + 1;
+    return acc;
+  }, {});
+  const itemsByReason = items.reduce(
+    (acc, item) => {
+      ;
+      (acc[item.reason] ??= []).push(item);
+      return acc;
+    },
+    {}
+  );
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: "Clean up" }),
+    /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: groups.map((reason, i) => {
+      const sel = i === cursor;
+      const checked = selected.has(reason);
+      const color = REASON_COLOR[reason] ?? "white";
+      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: i > 0 ? 1 : 0, children: [
+        /* @__PURE__ */ jsxs(Box, { gap: 2, children: [
+          /* @__PURE__ */ jsx(Text, { color: sel ? "cyan" : "gray", children: sel ? "\u25B6" : " " }),
+          /* @__PURE__ */ jsx(Text, { color: checked ? color : "gray", children: checked ? "[x]" : "[ ]" }),
+          /* @__PURE__ */ jsx(Text, { color: checked ? color : "gray", bold: checked, children: reason }),
+          /* @__PURE__ */ jsx(Text, { color: checked ? color : "gray", dimColor: true, children: countByReason[reason] })
+        ] }),
+        itemsByReason[reason].map((item) => /* @__PURE__ */ jsxs(Box, { paddingLeft: 6, gap: 1, children: [
+          /* @__PURE__ */ jsx(Text, { color: checked ? color : "gray", dimColor: true, children: "\u2502" }),
+          /* @__PURE__ */ jsx(Text, { color: checked ? "white" : "gray", dimColor: !checked, children: item.label })
+        ] }, item.label))
+      ] }, reason);
+    }) }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(
+      Hint,
+      {
+        pairs: [
+          ["\u2191\u2193", "nav"],
+          ["space", "toggle"],
+          ["a", "all"],
+          ["y", "confirm"],
+          ["n / esc", "cancel"]
+        ]
+      }
+    ) })
+  ] });
+};
+var CleanApp = () => {
+  const { exit } = useApp();
+  const [items, setItems] = useState(null);
+  const [done, setDone] = useState(false);
+  useEffect(() => {
+    findCleanItems().then(setItems);
+  }, []);
+  if (done) return /* @__PURE__ */ jsx(Text, { color: "green", children: " done" });
+  return /* @__PURE__ */ jsx(
+    CleanConfirm,
+    {
+      items,
+      onConfirm: (selected) => {
+        for (const item of selected) item.execute();
+        setDone(true);
+        setTimeout(exit, 300);
+      },
+      onCancel: exit
+    }
+  );
+};
+var App = () => {
+  const { exit } = useApp();
+  const [sessions, setSessions] = useState(null);
+  const [cursor, setCursor] = useState(0);
+  const [mode, setMode] = useState("list");
+  const [newName, setNewName] = useState("");
+  const [filter, setFilter] = useState("all");
+  const [search, setSearch] = useState("");
+  const [cleanItems, setCleanItems] = useState(null);
+  useEffect(() => {
+    loadSessions().then(setSessions);
+  }, []);
+  const chatSessions = sessions?.filter((s) => s.type === "chat") ?? [];
+  const codeSessions = sessions?.filter((s) => s.type === "code") ?? [];
+  const grouped = filter === "chat" ? chatSessions : filter === "code" ? codeSessions : [...chatSessions, ...codeSessions];
+  const filtered = search ? grouped.filter(
+    (s) => s.label.toLowerCase().includes(search.toLowerCase()) || s.path.toLowerCase().includes(search.toLowerCase())
+  ) : grouped;
+  const items = sessions ? [null, ...filtered] : [];
+  const doExit = (action) => {
+    pendingAction = action;
+    exit();
+  };
+  const cycleFilter = () => {
+    setFilter((f) => f === "all" ? "chat" : f === "chat" ? "code" : "all");
+    setCursor(0);
+  };
+  useInput(
+    (input, key) => {
+      if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
+      if (key.downArrow) setCursor((c) => Math.min(items.length - 1, c + 1));
+      if (key.tab) cycleFilter();
+      if (input === "/") {
+        setMode("search");
+        setSearch("");
+        setCursor(0);
+      }
+      if (key.return) {
+        if (cursor === 0) {
+          setMode("new");
+          setNewName("");
+        } else if (items[cursor])
+          doExit({ type: "open", dir: items[cursor].dir });
+      }
+      if (input === "d" && cursor > 0) setMode("confirm-delete");
+      if (input === "C") {
+        setCleanItems(null);
+        setMode("clean-confirm");
+        findCleanItems().then(setCleanItems);
+      }
+      if (input === "q" || key.escape) exit();
+    },
+    { isActive: mode === "list" && !!sessions }
+  );
+  useInput(
+    (input, key) => {
+      if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
+      if (key.downArrow) setCursor((c) => Math.min(items.length - 1, c + 1));
+      if (key.return) {
+        if (cursor === 0) {
+          setSearch("");
+          setMode("new");
+          setNewName("");
+        } else if (items[cursor])
+          doExit({ type: "open", dir: items[cursor].dir });
+      }
+      if (key.escape) {
+        setSearch("");
+        setMode("list");
+        setCursor(0);
+      }
+    },
+    { isActive: mode === "search" && !!sessions }
+  );
+  useInput(
+    (input, key) => {
+      if (input === "y") {
+        const item = items[cursor];
+        deleteSession(item);
+        setSessions((s) => s.filter((x) => x.dir !== item.dir));
+        setCursor((c) => Math.min(c, items.length - 2));
+        setMode("list");
+      }
+      if (input === "n" || key.escape) setMode("list");
+    },
+    { isActive: mode === "confirm-delete" }
+  );
+  useInput(
+    (_, key) => {
+      if (key.escape) setMode("list");
+    },
+    { isActive: mode === "new" }
+  );
+  if (!sessions) return /* @__PURE__ */ jsx(Text, { dimColor: true, children: " loading\u2026" });
+  if (mode === "new")
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: "New chat" }),
+      /* @__PURE__ */ jsxs(Box, { marginTop: 1, gap: 1, children: [
+        /* @__PURE__ */ jsx(Text, { color: "cyan", children: "\u203A" }),
+        /* @__PURE__ */ jsx(
+          TextInput,
+          {
+            value: newName,
+            onChange: setNewName,
+            onSubmit: (val) => {
+              if (!val.trim()) {
+                setMode("list");
+                return;
+              }
+              doExit({ type: "new", dir: join(CHATS_DIR, slugify(val.trim())) });
+            }
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Hint, { pairs: [["esc", "cancel"]] }) })
+    ] });
+  if (mode === "confirm-delete") {
+    const item = items[cursor];
+    const toDelete = [
+      ...item.type === "chat" ? [item.dir] : [],
+      ...item.claudeProjectDir ? [item.claudeProjectDir] : []
+    ];
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsxs(Text, { children: [
+        "Remove",
+        " ",
+        /* @__PURE__ */ jsx(Text, { color: "red", bold: true, children: item.label }),
+        "?"
+      ] }),
+      /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: toDelete.map((p) => /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+        " ",
+        p.replace(HOME, "~")
+      ] }, p)) }),
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(
+        Hint,
+        {
+          pairs: [
+            ["y", "confirm"],
+            ["n / esc", "cancel"]
+          ]
+        }
+      ) })
+    ] });
+  }
+  if (mode === "clean-confirm")
+    return /* @__PURE__ */ jsx(
+      CleanConfirm,
+      {
+        items: cleanItems,
+        onConfirm: (selected) => {
+          for (const item of selected) item.execute();
+          setMode("list");
+          loadSessions().then(setSessions);
+        },
+        onCancel: () => setMode("list")
+      }
+    );
+  const isSearching = mode === "search";
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingY: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { paddingX: 2, marginBottom: 1, gap: 1, children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "/" }),
+      isSearching ? /* @__PURE__ */ jsx(
+        TextInput,
+        {
+          value: search,
+          onChange: (v) => {
+            setSearch(v);
+            setCursor(0);
+          },
+          onSubmit: () => {
+          }
+        }
+      ) : /* @__PURE__ */ jsx(Text, { dimColor: true, children: search || "search\u2026" })
+    ] }),
+    items.map((item, i) => {
+      const sel = i === cursor;
+      const prev = items[i - 1];
+      const showChatHeader = !search && filter === "all" && item?.type === "chat" && prev?.type !== "chat";
+      const showCodeHeader = !search && filter === "all" && item?.type === "code" && prev?.type !== "code";
+      if (!item)
+        return /* @__PURE__ */ jsxs(Box, { paddingX: 2, children: [
+          /* @__PURE__ */ jsx(Text, { color: sel ? "cyan" : "gray", children: sel ? "\u25B6 " : "  " }),
+          /* @__PURE__ */ jsx(Text, { color: "white", bold: sel, children: "+ New chat" })
+        ] }, "new");
+      return /* @__PURE__ */ jsxs(React.Fragment, { children: [
+        showChatHeader && /* @__PURE__ */ jsx(SectionHeader, { label: "chat" }),
+        showCodeHeader && /* @__PURE__ */ jsx(SectionHeader, { label: "code" }),
+        /* @__PURE__ */ jsxs(Box, { paddingX: 2, gap: 2, children: [
+          /* @__PURE__ */ jsx(Text, { color: sel ? "cyan" : "gray", children: sel ? "\u25B6" : " " }),
+          /* @__PURE__ */ jsx(
+            Text,
+            {
+              color: item.type === "chat" ? "magenta" : "green",
+              bold: sel,
+              children: item.type === "chat" ? ICON_CHAT : ICON_CODE
+            }
+          ),
+          /* @__PURE__ */ jsx(Text, { color: "white", bold: sel, children: item.label }),
+          /* @__PURE__ */ jsx(Text, { color: "gray", bold: sel, children: item.path }),
+          /* @__PURE__ */ jsx(Text, { color: "yellow", bold: sel, dimColor: !sel, children: item.ago })
+        ] })
+      ] }, item.dir);
+    }),
+    /* @__PURE__ */ jsxs(Box, { marginTop: 1, paddingX: 2, gap: 3, children: [
+      /* @__PURE__ */ jsx(
+        Hint,
+        {
+          pairs: [
+            ["\u2191\u2193", "nav"],
+            ["enter", "open"],
+            ["d", "remove"],
+            ["/", "search"],
+            ["tab", "filter"],
+            ["C", "clean"],
+            ["q", "quit"]
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx(FilterBar, { filter })
+    ] })
+  ] });
+};
+mkdirSync(CHATS_DIR, { recursive: true });
+if (process.argv[2] === "clean") {
+  const { waitUntilExit } = render(/* @__PURE__ */ jsx(CleanApp, {}), { exitOnCtrlC: true });
+  await waitUntilExit();
+} else {
+  const { waitUntilExit } = render(/* @__PURE__ */ jsx(App, {}), { exitOnCtrlC: true });
+  await waitUntilExit();
+  if (pendingAction) {
+    const { type, dir } = pendingAction;
+    mkdirSync(dir, { recursive: true });
+    process.chdir(dir);
+    spawnSync("claude", type === "open" ? ["--continue"] : [], {
+      stdio: "inherit"
+    });
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kud/claude-sessions-cli",
+  "version": "1.0.0",
+  "description": "TUI session manager for Claude Code",
+  "type": "module",
+  "bin": {
+    "claude-sessions": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx src/index.tsx",
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ink": "6.8.0",
+    "ink-text-input": "6.0.0",
+    "react": "19.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "tsup": "^8.5.1",
+    "tsx": "4.21.0",
+    "typescript": "^6.0.2"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}