@chroxify/eunoe 1.0.0 → 1.2.0

package/src/cli/commands/status.ts

@@ -1,82 +1,125 @@
 import path from "node:path"
-import { loadConfig, modeFor, overrides } from "../../config"
-import { paths, RERANK_OFF } from "../../config/constants"
-import { rerankKey } from "../../context/rerank"
+import { type Config, modeFor, overrides, readConfig } from "../../config"
+import { paths } from "../../config/paths"
+import { rerankKey } from "../../context/recall/rerank"
+import type { Health } from "../../proxy/server"
 import { seenSessions } from "../../proxy/sessions"
 import { VERSION } from "../../version"
-import { proxyUrl } from "../claude-settings"
-import { MODE_DESCRIPTIONS, SESSIONS_SHOWN } from "../constants"
-import { probe, recentRequests, routedDirs } from "../inspect"
-import * as launchd from "../launchd"
+import type { Command } from "../command"
+import { BLOCKING_LIMIT_ENV, proxyUrl, readSettings } from "../proxy/claude-settings"
+import { probe, RECENT_REQUESTS, type RequestRecord, recentRequests, routedDirs, runsStaleCode } from "../proxy/inspect"
+import * as launchd from "../proxy/launchd"
+import { PROXY_AGENT } from "../proxy/service"
+import { perSession, type SessionStats, savedShare, type Totals, totals, withinWindow } from "../proxy/stats"
+import { readWatch } from "../proxy/watch"
 import { shortId } from "../sessions"
-import { perSession, savedShare, totals, withinWindow } from "../stats"
-import type { Command } from "../types"
-import { ago, c, line, percent, rows, table, tilde, tokens, warn } from "../ui"
+import { ago, c, line, percent, plural, rows, table, tilde, tokens, warn } from "../terminal/ui"
+import { MODE_DESCRIPTIONS } from "./mode"
 
 const dot = (on: boolean) => (on ? c.green("●") : c.red("○"))
 
+const settingsFiles = (dirs: string[]) => dirs.map((dir) => tilde(path.join(dir, "settings.json"))).join(", ")
+
+function summary(title: string, sum: Totals) {
+  const hit = sum.cacheRead + sum.cacheWrite + sum.uncached
+  const folds = sum.folds && sum.lastFold ? `  ${c.dim(`${plural(sum.folds, "fold")}, last ${ago(sum.lastFold)}`)}` : ""
+  const hitRate = hit ? c.dim(`  (${percent(sum.cacheRead / hit)} hit)`) : ""
+  const saved = sum.saved > 0 ? `${c.bold(c.green(tokens(sum.saved)))} input tokens not sent  ${c.dim(`(${percent(sum.saved / (sum.sent + sum.saved))} less than plain Claude Code)`)}` : c.dim("no data yet")
+  line()
+  line(`  ${title}`)
+  rows(
+    [
+      ["Requests", `${c.bold(sum.requests.toLocaleString())}${folds}`],
+      ["Cache", `${c.bold(tokens(sum.cacheRead))} read  ${c.dim("·")}  ${tokens(sum.cacheWrite)} written  ${c.dim("·")}  ${tokens(sum.uncached)} uncached${hitRate}`],
+      ["Saved", saved],
+    ],
+    4,
+  )
+}
+
+function recallLine(config: Config, recent: RequestRecord[]) {
+  if (config.rerank === "off") return "bm25"
+  if (!rerankKey()) return `bm25  ${c.dim(`(${config.rerank} needs a key in ${tilde(paths.typesafeKey)} or TYPESAFE_API_KEY)`)}`
+  const last = recent.findLast((r) => r.reranked || r.rerankError)
+  if (last?.rerankError) return `bm25  ${c.yellow(`(${config.rerank} failing: ${last.rerankError.replace(/^[^:]+: /, "")}, last ${ago(last.ts)})`)}`
+  return `bm25 ${c.dim("→")} ${config.rerank}`
+}
+
+function sessionRow(config: Config, stats: Map<string, SessionStats>, [id, session]: ReturnType<typeof seenSessions>[number]) {
+  const active = modeFor(config, id)
+  const own = Object.entries(overrides(config.sessions[id]))
+    .map(([name, value]) => `${name} ${value}`)
+    .join(" · ")
+  const stat = stats.get(id)
+  const managed = active !== "off"
+  const saved = stat ? savedShare(stat.context, stat.plain) : null
+  return [
+    c.cyan(shortId(id)),
+    managed ? c.green(active) : c.dim("off"),
+    session.cwd ? tilde(session.cwd) : c.dim("–"),
+    stat?.turns ? c.dim(`${stat.turns} turns`) : "",
+    stat && managed ? `${c.bold(tokens(stat.context))} ctx${stat.fixed ? c.dim(` (${tokens(stat.fixed)} fixed)`) : ""}` : "",
+    saved !== null && managed ? (saved > 0 ? c.green(`−${percent(saved)}`) : c.dim("±0")) : "",
+    c.dim(ago(session.lastSeen)),
+    own ? c.dim(own) : "",
+  ]
+}
+
+function sessionsTable(config: Config, stats: Map<string, SessionStats>) {
+  const sessions = seenSessions().slice(0, 5)
+  if (sessions.length === 0) return
+  line()
+  line(`  ${c.dim("Sessions")}`)
+  table(sessions.map((entry) => sessionRow(config, stats, entry)))
+}
+
+function warnings(config: Config, health: Health | null, routed: string[], recent: RequestRecord[]) {
+  const notes: string[] = []
+  const watch = readWatch()
+  if (watch.paused.length > 0)
+    notes.push(`The proxy stopped answering ${watch.pausedAt ? ago(watch.pausedAt) : ""}, so Claude Code was sent straight to the API. Routing comes back by itself once the proxy does; ${c.bold("eunoe start")} forces it.`)
+  if (health && health.mode !== config.mode) notes.push(`The running proxy reports mode ${health.mode}; it switches on its next request.`)
+  if (health && runsStaleCode(health)) notes.push(`The proxy is running older code than what's installed. ${c.bold("eunoe start")} restarts it.`)
+  const unguarded = config.mode !== "off" ? routed.filter((dir) => readSettings(dir).env?.[BLOCKING_LIMIT_ENV] === undefined) : []
+  if (unguarded.length > 0) notes.push(`Claude Code can still refuse to send near a full window in ${settingsFiles(unguarded)}. ${c.bold("eunoe start")} fixes it.`)
+  const missed = recent.filter((r) => r.overflow || r.fit === "over")
+  const lastMissed = missed.at(-1)
+  if (lastMissed) notes.push(`${missed.length} request${missed.length === 1 ? "" : "s"} didn't fit the window on the first try, last ${ago(lastMissed.ts)}. Details in ${tilde(paths.requests)}.`)
+  for (const text of notes) {
+    line()
+    warn(text)
+  }
+}
+
 export const status: Command = {
   summary: "Show what eunoe is doing and saving",
   usage: "eunoe status",
   async run() {
-    const config = loadConfig()
+    const config = readConfig()
     const health = await probe(config.port)
     const routed = routedDirs(config)
-    const recent = recentRequests()
-    const today = withinWindow(recent)
-    const stats = perSession(recent)
-    const sum = totals(today)
+    const all = recentRequests(Number.POSITIVE_INFINITY)
+    const recent = all.slice(-RECENT_REQUESTS)
+    const sum = totals(withinWindow(all))
+    const allTime = totals(all)
 
     line()
     line(`  ${c.bold("eunoe")} ${c.dim(VERSION)}`)
     line()
-
-    const recall = config.rerank === RERANK_OFF ? "bm25" : rerankKey() ? `bm25 ${c.dim("→")} ${config.rerank}` : `bm25  ${c.dim(`(${config.rerank} needs a key in ${tilde(paths.typesafeKey)} or TYPESAFE_API_KEY)`)}`
     rows([
-      ["Proxy", health ? `${dot(true)} running on ${c.cyan(proxyUrl(config.port))}${launchd.isInstalled() ? c.dim("  launchd") : ""}` : `${dot(false)} not running ${c.dim("(eunoe start)")}`],
-      ["Claude Code", routed.length ? `${dot(true)} routed ${c.dim(routed.map((dir) => tilde(path.join(dir, "settings.json"))).join(", "))}` : `${c.dim("○")} not routed ${c.dim("(eunoe start)")}`],
+      ["Proxy", health ? `${dot(true)} running on ${c.cyan(proxyUrl(config.port))}${launchd.isInstalled(PROXY_AGENT) ? c.dim("  launchd") : ""}` : `${dot(false)} not running ${c.dim("(eunoe start)")}`],
+      ["Claude Code", routed.length > 0 ? `${dot(true)} routed ${c.dim(settingsFiles(routed))}` : `${c.dim("○")} not routed ${c.dim("(eunoe start)")}`],
       ["Mode", `${c.bold(config.mode)}  ${c.dim(MODE_DESCRIPTIONS[config.mode])}`],
       ["Sessions", config.scope === "all" ? "all" : `only the ones you started it for ${c.dim("(eunoe start --session <id>)")}`],
-      ["Recall", recall],
+      ["Recall", recallLine(config, recent)],
     ])
 
-    const sessions = seenSessions().slice(0, SESSIONS_SHOWN)
-    if (sessions.length) {
-      line()
-      line(`  ${c.dim("Sessions")}`)
-      table(sessions.map(([id, session]) => {
-        const active = modeFor(config, id)
-        const own = Object.entries(overrides(config.sessions[id])).map(([name, value]) => `${name} ${value}`).join(" · ")
-        const stat = stats.get(id)
-        const saved = stat ? savedShare(stat.context, stat.plain) : null
-        return [
-          c.cyan(shortId(id)),
-          active === "off" ? c.dim("off") : c.green(active),
-          session.cwd ? tilde(session.cwd) : c.dim("–"),
-          stat?.turns ? c.dim(`${stat.turns} turns`) : "",
-          stat && active !== "off" ? `${c.bold(tokens(stat.context))} ctx` : "",
-          saved !== null && active !== "off" ? (saved > 0 ? c.green(`−${percent(saved)}`) : c.dim("±0")) : "",
-          c.dim(ago(session.lastSeen)),
-          own ? c.dim(own) : "",
-        ]
-      }))
-    }
+    sessionsTable(config, perSession(all))
 
-    if (sum.requests) {
-      const hit = sum.cacheRead + sum.cacheWrite + sum.uncached
-      line()
-      line(`  ${c.dim("Last 24h")}`)
-      rows([
-        ["Requests", `${c.bold(String(sum.requests))}${sum.folds ? `  ${c.dim(`${sum.folds} fold${sum.folds === 1 ? "" : "s"}, last ${ago(sum.lastFold!)}`)}` : ""}`],
-        ["Cache", `${c.bold(tokens(sum.cacheRead))} read  ${c.dim("·")}  ${tokens(sum.cacheWrite)} written  ${c.dim("·")}  ${tokens(sum.uncached)} uncached${hit ? c.dim(`  (${percent(sum.cacheRead / hit)} hit)`) : ""}`],
-        ["Saved", sum.saved > 0 ? `${c.bold(c.green(tokens(sum.saved)))} input tokens not sent  ${c.dim(`(${percent(sum.saved / (sum.sent + sum.saved))} less than plain Claude Code)`)}` : c.dim("no data yet")],
-      ], 4)
-    }
+    if (sum.requests) summary(c.dim("Last 24h"), sum)
+    if (allTime.requests > sum.requests) summary(`${c.dim("All time")}  ${c.dim(`since ${new Date(all[0].ts).toLocaleDateString()}`)}`, allTime)
 
-    if (health && health.mode !== config.mode) {
-      line()
-      warn(`The running proxy reports mode ${health.mode}; it switches on its next request.`)
-    }
+    warnings(config, health, routed, recent)
     line()
   },
 }

package/src/cli/commands/stop.ts

@@ -1,8 +1,9 @@
-import { claudeConfigDirs, loadConfig, saveConfig } from "../../config"
-import { editSettings, withoutEunoe } from "../claude-settings"
+import { claudeConfigDirs, readConfig, saveConfig } from "../../config"
+import type { Command } from "../command"
+import { editSettings, withoutEunoe } from "../proxy/claude-settings"
+import { clearWatch } from "../proxy/watch"
 import { sessionArgs, shortId } from "../sessions"
-import type { Command } from "../types"
-import { line, listFiles, note, ok } from "../ui"
+import { line, listFiles, note, ok } from "../terminal/ui"
 
 export const stop: Command = {
   summary: "Send new sessions straight to the API again",
@@ -16,9 +17,9 @@ export const stop: Command = {
   ],
   options: [["--session <id>", "Stop managing just this session (repeatable; a unique prefix is enough)"]],
   run(args) {
-    const config = loadConfig()
+    const config = readConfig()
     const ids = sessionArgs(args)
-    if (ids.length) {
+    if (ids.length > 0) {
       const sessions = { ...config.sessions }
       for (const id of ids) {
         if (config.scope === "all") sessions[id] = { ...sessions[id], mode: "off" }
@@ -29,6 +30,7 @@ export const stop: Command = {
       return
     }
     const touched = editSettings(claudeConfigDirs(config), (settings) => withoutEunoe(settings, config.port))
+    clearWatch()
     line()
     ok("Claude Code no longer routed through eunoe")
     listFiles(touched)

package/src/cli/commands/uninstall.ts

@@ -1,24 +1,22 @@
-import { claudeConfigDirs, loadConfig } from "../../config"
-import { editSettings, withoutEunoe } from "../claude-settings"
-import * as launchd from "../launchd"
-import type { Command } from "../types"
-import { c, line, listFiles, note, ok, warn } from "../ui"
+import { claudeConfigDirs, readConfig } from "../../config"
+import type { Command } from "../command"
+import { editSettings, withoutEunoe } from "../proxy/claude-settings"
+import { removeService } from "../proxy/service"
+import { clearWatch } from "../proxy/watch"
+import { c, line, listFiles, note, ok, warn } from "../terminal/ui"
 
 export const uninstall: Command = {
   summary: "Stop eunoe and remove the background proxy",
   usage: "eunoe uninstall",
-  details: [
-    "Everything `stop` does, then shuts the proxy down and removes its background service.",
-    "Sessions still running through eunoe lose their connection, so restart them first.",
-    "Your config and transcripts in ~/.eunoe are kept.",
-  ],
+  details: ["Everything `stop` does, then shuts the proxy down and removes its background service.", "Sessions still running through eunoe lose their connection, so restart them first.", "Your config and transcripts in ~/.eunoe are kept."],
   run() {
-    const config = loadConfig()
+    const config = readConfig()
     const touched = editSettings(claudeConfigDirs(config), (settings) => withoutEunoe(settings, config.port))
+    clearWatch()
     line()
     ok("Claude Code no longer routed through eunoe")
     listFiles(touched)
-    if (launchd.removeAgent()) ok("Background proxy stopped and removed")
+    if (removeService()) ok("Background proxy stopped and removed")
     else note("No background proxy was installed.")
     warn(`Restart any Claude Code session that was still using eunoe.`)
     line(`  ${c.dim("Data kept in")} ~/.eunoe`)

package/src/cli/commands/watch.ts

@@ -0,0 +1,16 @@
+import { readConfig } from "../../config"
+import type { Command } from "../command"
+import { runWatch } from "../proxy/watch"
+import { line } from "../terminal/ui"
+
+export const watch: Command = {
+  summary: "Check the proxy once and unroute Claude Code while it is down",
+  usage: "eunoe watch",
+  details: ["`eunoe start` schedules this in the background. When the proxy stops answering, Claude Code goes straight to the API; when it is back, routing returns."],
+  hidden: true,
+  async run() {
+    const step = await runWatch(readConfig())
+    for (const dir of step.pause) line(`eunoe watch  proxy down, routing removed from ${dir}`)
+    for (const dir of step.resume) line(`eunoe watch  proxy back, routing restored in ${dir}`)
+  },
+}

package/src/cli/logo/art.ts

@@ -0,0 +1,99 @@
+export const HALF_BLOCKS = " ▀▄█"
+export const OCTANTS = [
+  ..." 𜺨𜺫🮂𜴀▘𜴁𜴂𜴃𜴄▝𜴅𜴆𜴇𜴈▀𜴉𜴊𜴋𜴌🯦𜴍𜴎𜴏𜴐𜴑𜴒𜴓𜴔𜴕𜴖𜴗𜴘𜴙𜴚𜴛𜴜𜴝𜴞𜴟🯧𜴠𜴡𜴢𜴣𜴤𜴥𜴦𜴧𜴨𜴩𜴪𜴫𜴬𜴭𜴮𜴯𜴰𜴱𜴲𜴳𜴴𜴵🮅𜺣𜴶𜴷𜴸𜴹𜴺𜴻𜴼𜴽𜴾𜴿𜵀𜵁𜵂𜵃𜵄▖𜵅𜵆𜵇𜵈▌𜵉𜵊𜵋𜵌▞𜵍𜵎𜵏𜵐▛𜵑𜵒𜵓𜵔𜵕𜵖𜵗𜵘𜵙𜵚𜵛𜵜𜵝𜵞𜵟𜵠𜵡𜵢𜵣𜵤𜵥𜵦𜵧𜵨𜵩𜵪𜵫𜵬𜵭𜵮𜵯𜵰𜺠𜵱𜵲𜵳𜵴𜵵𜵶𜵷𜵸𜵹𜵺𜵻𜵼𜵽𜵾𜵿𜶀𜶁𜶂𜶃𜶄𜶅𜶆𜶇𜶈𜶉𜶊𜶋𜶌𜶍𜶎𜶏▗𜶐𜶑𜶒𜶓▚𜶔𜶕𜶖𜶗▐𜶘𜶙𜶚𜶛▜𜶜𜶝𜶞𜶟𜶠𜶡𜶢𜶣𜶤𜶥𜶦𜶧𜶨𜶩𜶪𜶫▂𜶬𜶭𜶮𜶯𜶰𜶱𜶲𜶳𜶴𜶵𜶶𜶷𜶸𜶹𜶺𜶻𜶼𜶽𜶾𜶿𜷀𜷁𜷂𜷃𜷄𜷅𜷆𜷇𜷈𜷉𜷊𜷋𜷌𜷍𜷎𜷏𜷐𜷑𜷒𜷓𜷔𜷕𜷖𜷗𜷘𜷙𜷚▄𜷛𜷜𜷝𜷞▙𜷟𜷠𜷡𜷢▟𜷣▆𜷤𜷥█",
+]
+
+export const KEYS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456"
+
+export const PALETTE = [
+  "#fefefd",
+  "#fdfcf1",
+  "#fef7db",
+  "#fef7da",
+  "#fdf7dc",
+  "#fef7d9",
+  "#fdf6d9",
+  "#fef6d6",
+  "#fdf6d7",
+  "#fdf4d5",
+  "#fdf6cf",
+  "#fef4ae",
+  "#fde9a5",
+  "#feec97",
+  "#fde186",
+  "#fddb6b",
+  "#fdd763",
+  "#fdd661",
+  "#fdd55d",
+  "#fcd259",
+  "#fdcd49",
+  "#fdc524",
+  "#f6f5de",
+  "#f5e6b1",
+  "#d7ecc9",
+  "#e2d596",
+  "#e5b93b",
+  "#7ce5d0",
+  "#68dbd4",
+  "#74cdd0",
+  "#52d1cc",
+  "#33c4c9",
+  "#2bc0c7",
+  "#2abcc5",
+  "#29bbc4",
+  "#27bcc5",
+  "#20bccc",
+  "#27bac3",
+  "#24b7bc",
+  "#12b3d0",
+  "#0baccd",
+  "#0fa7b4",
+  "#7f7870",
+  "#0678a5",
+  "#038abb",
+  "#04527e",
+  "#018cd0",
+  "#016b95",
+  "#014b85",
+  "#01417b",
+  "#023d73",
+  "#013a71",
+  "#033b6a",
+  "#023768",
+  "#013367",
+  "#092945",
+  "#002d56",
+  "#071a2c",
+  "#041223",
+]
+
+export const PIXELS = [
+  "..............W4...........a",
+  ".............Xutt..........U",
+  ".........tt...kuut.......uu.",
+  "........tkr...1Yxt4tT....u..",
+  "...XXW..soq...X2Xtst0.......",
+  "..TqssW.xr6...0CJRXs4.......",
+  "..oCCCsW.srrr012S4R1s.1.....",
+  "..kCCPrsV.ttslRSRJCFEB0m....",
+  "...pCPPrqW4W43nJJJJJHCG0....",
+  "...koCPR0sppHEtEILIHHHGhTrq.",
+  "....oCOSSZSFFEFFIIIHHHhhkEp.",
+  "XXX..nyEVPByEEEGGIIIHHLbwLo.",
+  "YrrYYY04WMGFEEggdhIIHHH63Vx.",
+  ".rqnnnxKKLwFifg66hhHHGJ6ujTe",
+  ".ZrpoCNSLKkGfh3355fffB4ejmj.",
+  "..1qpCY1PMLFfg3553hhhh.ihgRw",
+  ".....ZZ2POJGdd653AdcgQQhfe..",
+  ".....ZZPZPJdxjj6vcddcAAffT..",
+  ".CC.YpCE2VhGkjmmfdcddghdT..A",
+  "....Xpp1ZVRVxhhfgddfffTT..Ab",
+  ".....1Z2pC02VxxkxxgnmzA....6",
+  ".......qrp2ewVPMxxmmavvv6..A",
+  "..UU...YXY..PPFkEkkvvaaavA..",
+  ".UUCU......XXPMCkkvalanxavvN",
+  ".UCyUNN..1Yu4PMP055nlalxBavN",
+  "..UU.NN.1uD2PwJ0MP33nlmyBuav",
+  "QyDy3y..uo2RRwFPPPP6nnBBavaa",
+  "DQQQDyy.tB2RVPPPSR4poBBaaB6N",
+]

package/src/cli/logo/index.ts

@@ -1,6 +1,5 @@
-import { HALF_BLOCKS, OCTANT_TERMINALS, OCTANTS, TRANSPARENT_PIXEL } from "../constants"
-import { trueColor, useColor } from "../ui"
-import { LOGO_KEYS, LOGO_PALETTE, LOGO_PIXELS } from "./pixels"
+import { trueColor, useColor } from "../terminal/ui"
+import { HALF_BLOCKS, KEYS, OCTANTS, PALETTE, PIXELS } from "./art"
 
 type Rgb = [number, number, number]
 type Pixel = Rgb | null
@@ -9,8 +8,6 @@ const rgb = (hex: string): Rgb => [1, 3, 5].map((i) => Number.parseInt(hex.slice
 
 const toCube = (value: number) => (value < 48 ? 0 : value < 115 ? 1 : Math.min(5, Math.round((value - 35) / 40)))
 
-const MISMATCH = 3 * 255 ** 2
-
 function sgr(color: Rgb, layer: "fg" | "bg") {
   const base = layer === "fg" ? 38 : 48
   if (trueColor) return `${base};2;${color.join(";")}`
@@ -19,12 +16,12 @@ function sgr(color: Rgb, layer: "fg" | "bg") {
 }
 
 function pixel(key: string | undefined): Pixel {
-  if (!key || key === TRANSPARENT_PIXEL) return null
-  return rgb(LOGO_PALETTE[LOGO_KEYS.indexOf(key)])
+  if (!key || key === ".") return null
+  return rgb(PALETTE[KEYS.indexOf(key)])
 }
 
 function distance(a: Pixel, b: Pixel) {
-  if (!a || !b) return a === b ? 0 : MISMATCH
+  if (!a || !b) return a === b ? 0 : 3 * 255 ** 2
   return (a[0] - b[0]) ** 2 + (a[1] - b[1]) ** 2 + (a[2] - b[2]) ** 2
 }
 
@@ -57,26 +54,23 @@ function cell(block: Pixel[], glyphs: string[]) {
 }
 
 function supportsOctants() {
-  const terminal = `${process.env.TERM_PROGRAM ?? ""} ${process.env.TERM ?? ""}`.toLowerCase()
-  return OCTANT_TERMINALS.some((name) => terminal.includes(name))
+  return `${process.env.TERM_PROGRAM ?? ""} ${process.env.TERM ?? ""}`.toLowerCase().includes("ghostty")
 }
 
 function region(x: number, y: number, width: number, height: number): Pixel[] {
   const block: Pixel[] = []
-  for (let dy = 0; dy < height; dy += 1) for (let dx = 0; dx < width; dx += 1) block.push(pixel(LOGO_PIXELS[y + dy]?.[x + dx]))
+  for (let dy = 0; dy < height; dy += 1) for (let dx = 0; dx < width; dx += 1) block.push(pixel(PIXELS[y + dy]?.[x + dx]))
   return block
 }
 
-export function logoLines(): string[] {
+function logoLines(): string[] {
   if (!useColor) return []
   const octants = supportsOctants()
   const lines: string[] = []
-  for (let y = 0; y < LOGO_PIXELS.length; y += 4) {
+  for (let y = 0; y < PIXELS.length; y += 4) {
     let row = ""
-    for (let x = 0; x < LOGO_PIXELS[0].length; x += 2) {
-      row += octants
-        ? cell(region(x, y, 2, 4), OCTANTS)
-        : cell([dominant(region(x, y, 2, 2)), dominant(region(x, y + 2, 2, 2))], [...HALF_BLOCKS])
+    for (let x = 0; x < PIXELS[0].length; x += 2) {
+      row += octants ? cell(region(x, y, 2, 4), OCTANTS) : cell([dominant(region(x, y, 2, 2)), dominant(region(x, y + 2, 2, 2))], [...HALF_BLOCKS])
     }
     lines.push(row)
   }
@@ -85,5 +79,5 @@ export function logoLines(): string[] {
 
 export function withLogo(text: string[]): string[] {
   const logo = logoLines()
-  return [...logo.map((row) => `  ${row}`), ...(logo.length ? [""] : []), ...text.map((entry) => `  ${entry}`)]
+  return [...logo.map((row) => `  ${row}`), ...(logo.length > 0 ? [""] : []), ...text.map((entry) => `  ${entry}`)]
 }

package/src/cli/main.ts

@@ -1,9 +1,9 @@
 #!/usr/bin/env bun
 import { VERSION } from "../version"
-import { wantsHelp } from "./args"
 import { commands } from "./commands"
-import { printCommandHelp, printHelp } from "./help"
-import { closest, fail, line } from "./ui"
+import { wantsHelp } from "./terminal/args"
+import { printCommandHelp, printHelp } from "./terminal/help"
+import { closest, fail, line } from "./terminal/ui"
 
 const [name, ...args] = process.argv.slice(2)
 

package/src/cli/proxy/claude-settings.ts

@@ -0,0 +1,69 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs"
+import path from "node:path"
+
+export interface Settings {
+  env?: Record<string, string>
+  autoCompactEnabled?: boolean
+  [key: string]: unknown
+}
+
+const CLAUDE_CLEANUP_DAYS = 30
+
+export const BLOCKING_LIMIT_ENV = "CLAUDE_CODE_BLOCKING_LIMIT_OVERRIDE"
+export const BLOCKING_LIMIT_OFF = "1000000000"
+
+export const proxyUrl = (port: number) => `http://127.0.0.1:${port}`
+
+export const pointsAtEunoe = (settings: Settings, port: number) => settings.env?.ANTHROPIC_BASE_URL === proxyUrl(port)
+
+function withoutEnv(settings: Settings, name: string): Settings {
+  if (!settings.env || !(name in settings.env)) return settings
+  const { [name]: _, ...env } = settings.env
+  const next: Settings = { ...settings, env }
+  if (Object.keys(env).length === 0) delete next.env
+  return next
+}
+
+export function withCompactionOwner(settings: Settings, mode: string): Settings {
+  if (mode !== "off") return { ...settings, autoCompactEnabled: false, env: { ...settings.env, [BLOCKING_LIMIT_ENV]: BLOCKING_LIMIT_OFF } }
+  const { autoCompactEnabled: _, ...rest } = settings
+  return rest.env?.[BLOCKING_LIMIT_ENV] === BLOCKING_LIMIT_OFF ? withoutEnv(rest, BLOCKING_LIMIT_ENV) : rest
+}
+
+export function withEunoe(settings: Settings, port: number, mode: string): Settings {
+  return withCompactionOwner({ ...settings, env: { ...settings.env, ANTHROPIC_BASE_URL: proxyUrl(port) } }, mode)
+}
+
+export function withoutEunoe(settings: Settings, port: number): Settings {
+  return withCompactionOwner(pointsAtEunoe(settings, port) ? withoutEnv(settings, "ANTHROPIC_BASE_URL") : settings, "off")
+}
+
+export function readSettings(dir: string): Settings {
+  try {
+    return JSON.parse(readFileSync(path.join(dir, "settings.json"), "utf8"))
+  } catch {
+    return {}
+  }
+}
+
+export function cleanupDays(configDirs: string[]): number {
+  for (const dir of configDirs) {
+    const days = readSettings(dir).cleanupPeriodDays
+    if (typeof days === "number") return days
+  }
+  return CLAUDE_CLEANUP_DAYS
+}
+
+export function editSettings(dirs: string[], edit: (settings: Settings) => Settings): string[] {
+  const touched: string[] = []
+  for (const dir of dirs) {
+    if (!existsSync(dir)) continue
+    const file = path.join(dir, "settings.json")
+    const current: Settings = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")) : {}
+    const next = edit(current)
+    if (JSON.stringify(next) === JSON.stringify(current)) continue
+    writeFileSync(file, `${JSON.stringify(next, null, 2)}\n`)
+    touched.push(file)
+  }
+  return touched
+}

package/src/cli/proxy/inspect.ts

@@ -0,0 +1,67 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs"
+import path from "node:path"
+import { type Config, claudeConfigDirs } from "../../config"
+import { paths } from "../../config/paths"
+import { HEALTH_PATH, type Health } from "../../proxy/server"
+import { parseJsonl } from "../../transcript/parse"
+import { pointsAtEunoe, proxyUrl, readSettings } from "./claude-settings"
+
+export interface RequestRecord {
+  ts: string
+  action?: string
+  thread?: string | null
+  input?: number
+  charsIn?: number
+  charsOut?: number
+  charsFixed?: number
+  cacheRead?: number
+  cacheWrite?: number
+  uncached?: number
+  compacted?: boolean
+  turns?: number
+  reranked?: string
+  rerankError?: string
+  overflow?: number
+  fit?: string
+  [key: string]: unknown
+}
+
+export const RECENT_REQUESTS = 5_000
+
+export async function probe(port: number): Promise<Health | null> {
+  try {
+    const response = await fetch(`${proxyUrl(port)}${HEALTH_PATH}`, { signal: AbortSignal.timeout(800) })
+    if (!response.ok) return null
+    return (await response.json()) as Health
+  } catch {
+    return null
+  }
+}
+
+function newestSource(dir: string): number {
+  let newest = 0
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const file = path.join(dir, entry.name)
+    if (entry.isDirectory()) newest = Math.max(newest, newestSource(file))
+    else if (entry.name.endsWith(".ts")) newest = Math.max(newest, statSync(file).mtimeMs)
+  }
+  return newest
+}
+
+export function runsStaleCode(health: Health | null): boolean {
+  if (!health?.startedAt) return health !== null
+  try {
+    return newestSource(path.join(import.meta.dir, "..")) > health.startedAt
+  } catch {
+    return false
+  }
+}
+
+export function routedDirs(config: Config) {
+  return claudeConfigDirs(config).filter((dir) => pointsAtEunoe(readSettings(dir), config.port))
+}
+
+export function recentRequests(limit = RECENT_REQUESTS): RequestRecord[] {
+  if (!existsSync(paths.requests)) return []
+  return parseJsonl<RequestRecord>(readFileSync(paths.requests, "utf8")).slice(-limit)
+}

package/src/cli/proxy/launchd.ts

@@ -0,0 +1,53 @@
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs"
+import path from "node:path"
+
+export interface Agent {
+  label: string
+  plist: string
+  interval?: number
+}
+
+export const supported = process.platform === "darwin"
+
+export function isInstalled(agent: Agent) {
+  return existsSync(agent.plist)
+}
+
+function plistFor(agent: Agent, program: string[], logFile: string) {
+  const args = program.map((arg) => `<string>${arg}</string>`).join("")
+  const schedule = agent.interval ? `<key>StartInterval</key><integer>${agent.interval}</integer>` : `<key>KeepAlive</key><true/>\n  <key>ThrottleInterval</key><integer>1</integer>`
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>${agent.label}</string>
+  <key>ProgramArguments</key><array>${args}</array>
+  <key>RunAtLoad</key><true/>
+  ${schedule}
+  <key>StandardOutPath</key><string>${logFile}</string>
+  <key>StandardErrorPath</key><string>${logFile}</string>
+</dict></plist>
+`
+}
+
+export function installAgent(agent: Agent, program: string[], logFile: string) {
+  mkdirSync(path.dirname(agent.plist), { recursive: true })
+  const plist = plistFor(agent, program, logFile)
+  if (existsSync(agent.plist) && readFileSync(agent.plist, "utf8") === plist) {
+    Bun.spawnSync(["launchctl", "load", agent.plist])
+    return
+  }
+  writeFileSync(agent.plist, plist)
+  Bun.spawnSync(["launchctl", "unload", agent.plist])
+  Bun.spawnSync(["launchctl", "load", agent.plist])
+}
+
+export function restartAgent(agent: Agent) {
+  Bun.spawnSync(["launchctl", "kickstart", "-k", `gui/${process.getuid?.() ?? ""}/${agent.label}`])
+}
+
+export function removeAgent(agent: Agent) {
+  if (!existsSync(agent.plist)) return false
+  Bun.spawnSync(["launchctl", "unload", agent.plist])
+  unlinkSync(agent.plist)
+  return true
+}