aisessions 1.0.0

package/README.md

@@ -0,0 +1,24 @@
+# aisessions
+
+Browse, manage, and analyze local AI coding agent sessions from one browser UI.
+
+## Usage
+
+```sh
+npx aisessions
+```
+
+Options:
+
+```sh
+npx aisessions --port 7879
+npx aisessions --no-open
+npx aisessions --help
+```
+
+The server binds to `127.0.0.1` and opens the UI in your browser by default.
+
+## Data
+
+The tool reads local agent session folders such as `~/.claude/projects` and
+`~/.codex`. Trash and backup data is stored under `~/.aisessions`.

package/bin/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { createServer } from '../src/server.js'
+import { parseArgs }    from 'node:util'
+import { exec }         from 'node:child_process'
+
+const VERSION = '1.0.0'
+
+const { values } = parseArgs({
+  options: {
+    port:      { type: 'string',  short: 'p', default: '7878' },
+    'no-open': { type: 'boolean', default: false },
+    help:      { type: 'boolean', short: 'h', default: false },
+    version:   { type: 'boolean', short: 'v', default: false },
+  },
+  strict: false,
+})
+
+if (values.version) { console.log(`aisessions v${VERSION}`); process.exit(0) }
+
+if (values.help) {
+  console.log(`
+  aisessions v${VERSION} — AI coding agent session manager
+
+  Usage:  npx aisessions [options]
+
+  Options:
+    -p, --port <port>   Port to listen on  (default: 7878)
+    --no-open           Don't auto-open browser
+    -h, --help          Show this help
+    -v, --version       Show version
+
+  Manages sessions for:
+    Claude Code · Codex · OpenCode · Amp · Goose · Gemini CLI
+
+  Data folders (read-only unless you delete/trash/backup):
+    ~/.claude/projects/   ~/.codex/
+
+  Trash & backup folder:
+    ~/.aisessions/
+  `)
+  process.exit(0)
+}
+
+const PORT = parseInt(values.port, 10) || 7878
+const server = createServer()
+
+server.listen(PORT, '127.0.0.1', () => {
+  const url = `http://127.0.0.1:${PORT}`
+  console.log(`\n  aisessions  ready ->  ${url}\n`)
+
+  if (!values['no-open']) {
+    const cmd = process.platform === 'darwin' ? `open "${url}"` :
+                process.platform === 'win32'  ? `start "${url}"` :
+                                                `xdg-open "${url}"`
+    exec(cmd, () => {})
+  }
+})
+
+server.on('error', err => {
+  if (err.code === 'EADDRINUSE')
+    console.error(`  Port ${PORT} is in use. Try: npx aisessions --port ${PORT + 1}`)
+  else
+    console.error('  Server error:', err.message)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "aisessions",
+  "version": "1.0.0",
+  "description": "Browse, manage and analyze your AI coding agent sessions — Claude Code, Codex, and more",
+  "bin": {
+    "aisessions": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node bin/cli.js",
+    "dev": "node bin/cli.js --no-open"
+  },
+  "keywords": [
+    "claude",
+    "codex",
+    "ai",
+    "sessions",
+    "aisessions",
+    "ccusage"
+  ],
+  "license": "MIT"
+}

package/src/agents/amp.js

@@ -0,0 +1,51 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import {
+  readLimited, parseJsonl, pathSize, humanSize, ignored,
+  titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate,
+} from './utils.js'
+
+const HOME       = homedir()
+const DATA_DIR   = process.env.AMP_DATA_DIR || join(HOME, '.amp')
+const THREAD_DIR = join(DATA_DIR, 'threads')
+
+export const AGENT_ID    = 'amp'
+export const AGENT_LABEL = 'Amp CLI'
+export const AGENT_COLOR = '#a0a0a0'
+
+export function isInstalled() { return existsSync(DATA_DIR) }
+
+export async function loadSessions() {
+  const items = []
+  if (!existsSync(THREAD_DIR)) return items
+
+  const walk = dir => {
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name.endsWith('.json')) {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp   = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({
+            agent: AGENT_ID, agentLabel: AGENT_LABEL,
+            path: full, sessionId: basename(full, e.name.endsWith('.jsonl') ? '.jsonl' : '.json'),
+            title: title || fileTitle(full), titleSource: tsrc || 'filename',
+            project: projName(pp), projectPath: pp,
+            date, dateLabel: fmtDate(date),
+            size, sizeLabel: humanSize(size),
+            filename: e.name, msgCount: objs.length,
+          })
+        }
+      }
+    } catch {}
+  }
+  walk(THREAD_DIR)
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/claude.js

@@ -0,0 +1,102 @@
+import { homedir }   from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import {
+  readLimited, parseJsonl, cleanStr, badTitle, truncStr,
+  dateFromPath, projName, pathSize, humanSize, ignored,
+  CLAUDE_SKIP_PREFIX, fileTitle, fmtDate,
+} from './utils.js'
+
+const HOME        = homedir()
+const CLAUDE_DIR  = process.env.CLAUDE_CONFIG_DIR || join(HOME, '.claude')
+const PROJ_DIR    = join(CLAUDE_DIR, 'projects')
+
+export const AGENT_ID    = 'claude'
+export const AGENT_LABEL = 'Claude Code'
+export const AGENT_COLOR = '#e0e0e0'
+
+export function isInstalled() { return existsSync(PROJ_DIR) }
+
+function claudeTexts(content) {
+  if (typeof content === 'string') return [content]
+  if (Array.isArray(content)) {
+    return content.flatMap(b => {
+      if (typeof b === 'string') return [b]
+      if (b && typeof b.text === 'string') return [b.text]
+      return []
+    })
+  }
+  return []
+}
+
+function isMeta(s) {
+  s = s.trimStart()
+  return s.startsWith('<') && CLAUDE_SKIP_PREFIX.some(p => s.startsWith(p))
+}
+
+export async function loadSessions() {
+  const items = []
+  if (!existsSync(PROJ_DIR)) return items
+
+  let projDirs
+  try { projDirs = readdirSync(PROJ_DIR, { withFileTypes: true }).filter(e => e.isDirectory()) }
+  catch { return items }
+
+  for (const pd of projDirs) {
+    const projPath = join(PROJ_DIR, pd.name)
+    let sessFiles
+    try { sessFiles = readdirSync(projPath).filter(f => f.endsWith('.jsonl')).sort() }
+    catch { continue }
+
+    for (const sf of sessFiles) {
+      const sessPath = join(projPath, sf)
+      if (ignored(sessPath)) continue
+
+      const sid = basename(sf, '.jsonl')
+      let title = '', pp = '', date = null, msgCount = 0
+
+      for (const line of readLimited(sessPath).split('\n')) {
+        const l = line.trim()
+        if (!l) continue
+        let obj
+        try { obj = JSON.parse(l) } catch { continue }
+        msgCount++
+
+        if (!pp && typeof obj.cwd === 'string' && obj.cwd.startsWith('/')) pp = obj.cwd
+
+        if (date === null && obj.timestamp) {
+          try { date = new Date(obj.timestamp) } catch {}
+        }
+
+        if (!title && !obj.isMeta) {
+          const msg = obj.message
+          if (msg && msg.role === 'user') {
+            for (const t of claudeTexts(msg.content || '')) {
+              const tc = cleanStr(t)
+              if (tc && !isMeta(tc)) {
+                const tr = truncStr(tc)
+                if (!badTitle(tr)) { title = tr; break }
+              }
+            }
+          }
+        }
+      }
+
+      if (!title) title = fileTitle(sessPath)
+      if (!pp) pp = pd.name.startsWith('-') ? '/' + pd.name.slice(1).replace(/-/g, '/') : pd.name
+      if (!date) date = dateFromPath(sessPath)
+      const size = pathSize(sessPath)
+
+      items.push({
+        agent: AGENT_ID, agentLabel: AGENT_LABEL,
+        path: sessPath, sessionId: sid,
+        title, titleSource: title ? 'user message' : 'filename',
+        project: projName(pp), projectPath: pp,
+        date, dateLabel: fmtDate(date),
+        size, sizeLabel: humanSize(size),
+        filename: sf, msgCount,
+      })
+    }
+  }
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/codebuff.js

@@ -0,0 +1,38 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import { readLimited, parseJsonl, pathSize, humanSize, ignored, titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate } from './utils.js'
+
+const HOME     = homedir()
+const DATA_DIR = process.env.CODEBUFF_DATA_DIR || join(HOME, '.codebuff')
+
+export const AGENT_ID    = 'codebuff'
+export const AGENT_LABEL = 'Codebuff'
+export const AGENT_COLOR = '#777'
+
+export function isInstalled() { return existsSync(DATA_DIR) }
+
+export async function loadSessions() {
+  const items = []
+  const walk = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name.endsWith('.json')) {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({ agent: AGENT_ID, agentLabel: AGENT_LABEL, path: full, sessionId: basename(full, e.name.endsWith('.jsonl') ? '.jsonl' : '.json'), title: title || fileTitle(full), titleSource: tsrc || 'filename', project: projName(pp), projectPath: pp, date, dateLabel: fmtDate(date), size, sizeLabel: humanSize(size), filename: e.name, msgCount: objs.length })
+        }
+      }
+    } catch {}
+  }
+  walk(DATA_DIR)
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/codex.js

@@ -0,0 +1,118 @@
+import { homedir }   from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import {
+  readLimited, parseJsonl, cleanStr, badTitle, truncStr,
+  sidFromPath, dateFromPath, projName, pathSize, humanSize,
+  ignored, PROJECT_KEYS, findStrings, titleFromObjs, regexTitle,
+  fileTitle, guessProj, fmtDate,
+} from './utils.js'
+
+const HOME      = homedir()
+const CODEX_DIR = process.env.CODEX_HOME || join(HOME, '.codex')
+const SESS_DIRS = [join(CODEX_DIR, 'sessions'), join(CODEX_DIR, 'browser', 'sessions')]
+const IDX_FILES = [
+  join(CODEX_DIR, 'session_index.jsonl'),
+  join(CODEX_DIR, 'history.jsonl'),
+  join(CODEX_DIR, 'history.json'),
+  join(CODEX_DIR, 'transcription-history.jsonl'),
+]
+const PROTECTED = new Set(['config.toml','auth.json','credentials.json','settings.json'])
+
+export const AGENT_ID    = 'codex'
+export const AGENT_LABEL = 'Codex'
+export const AGENT_COLOR = '#c0c0c0'
+
+export function isInstalled() { return existsSync(CODEX_DIR) }
+
+function buildIndex() {
+  const idx = {}
+  for (const f of IDX_FILES) {
+    if (!existsSync(f)) continue
+    const objs = parseJsonl(readLimited(f, 12_000_000))
+    for (const obj of objs) {
+      const strs = findStrings(obj, new Set(['id','session_id','conversation_id','path','file','filename','session_path']))
+      const ids  = new Set()
+      for (const s of strs) {
+        const sc = cleanStr(s)
+        const m  = sc.match(/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i)
+        if (m) ids.add(m[1])
+        if (sc.endsWith('.json') || sc.endsWith('.jsonl')) {
+          ids.add(basename(sc).replace(/\.(jsonl|json)$/, ''))
+        }
+      }
+      const [t, ts] = titleFromObjs([obj])
+      const pp = findStrings(obj, PROJECT_KEYS).find(v => v.includes('/') || v.includes('\\')) || ''
+      for (const sid of ids) {
+        if (!idx[sid] || (t && !idx[sid].title)) idx[sid] = { title: t, titleSource: ts, project: pp }
+      }
+    }
+  }
+  return idx
+}
+
+function isSubagent(text) {
+  for (const line of text.split('\n').slice(0, 20)) {
+    const l = line.trim()
+    if (!l) continue
+    try {
+      const obj = JSON.parse(l)
+      if (obj.type === 'session_meta') {
+        return cleanStr(String(obj.payload?.thread_source || '')).toLowerCase() === 'subagent'
+      }
+    } catch {}
+  }
+  return false
+}
+
+function allSessFiles() {
+  const files = []
+  const walk  = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full) || PROTECTED.has(e.name)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.json') || e.name.endsWith('.jsonl')) files.push(full)
+      }
+    } catch {}
+  }
+  SESS_DIRS.forEach(walk)
+  return files
+}
+
+export async function loadSessions() {
+  const idx   = buildIndex()
+  const items = []
+
+  for (const p of allSessFiles()) {
+    const sid  = sidFromPath(p)
+    const text = readLimited(p)
+    if (isSubagent(text)) continue
+
+    const objs = parseJsonl(text)
+    const info = idx[sid] || {}
+
+    let [title, tsrc] = ['', '']
+    if (info.title && !badTitle(info.title)) { title = truncStr(info.title); tsrc = 'index' }
+    if (!title) [title, tsrc] = titleFromObjs(objs)
+    if (!title) [title, tsrc] = regexTitle(text)
+    if (!title) { title = fileTitle(p); tsrc = 'filename' }
+
+    const pp   = info.project || guessProj(text) || 'Unknown'
+    const date = dateFromPath(p)
+    const size = pathSize(p)
+
+    items.push({
+      agent: AGENT_ID, agentLabel: AGENT_LABEL,
+      path: p, sessionId: sid,
+      title, titleSource: tsrc,
+      project: projName(pp), projectPath: pp,
+      date, dateLabel: fmtDate(date),
+      size, sizeLabel: humanSize(size),
+      filename: basename(p), msgCount: objs.length,
+    })
+  }
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/copilot.js

@@ -0,0 +1,43 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import { readLimited, parseJsonl, pathSize, humanSize, ignored, titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate } from './utils.js'
+
+const HOME = homedir()
+const CANDIDATE_DIRS = [
+  process.env.COPILOT_DATA_DIR,
+  join(HOME, '.config', 'github-copilot'),
+  join(HOME, 'Library', 'Application Support', 'GitHub Copilot'),
+  join(HOME, '.github-copilot'),
+].filter(Boolean)
+
+export const AGENT_ID    = 'copilot'
+export const AGENT_LABEL = 'Copilot'
+export const AGENT_COLOR = '#ccc'
+
+export function isInstalled() { return CANDIDATE_DIRS.some(d => existsSync(d)) }
+
+export async function loadSessions() {
+  const items = []
+  const walk = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name.endsWith('.json')) {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({ agent: AGENT_ID, agentLabel: AGENT_LABEL, path: full, sessionId: basename(full, e.name.endsWith('.jsonl') ? '.jsonl' : '.json'), title: title || fileTitle(full), titleSource: tsrc || 'filename', project: projName(pp), projectPath: pp, date, dateLabel: fmtDate(date), size, sizeLabel: humanSize(size), filename: e.name, msgCount: objs.length })
+        }
+      }
+    } catch {}
+  }
+  CANDIDATE_DIRS.forEach(walk)
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/cursor.js

@@ -0,0 +1,53 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import {
+  readLimited, parseJsonl, pathSize, humanSize, ignored,
+  titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate,
+} from './utils.js'
+
+const HOME      = homedir()
+const DATA_DIRS = [
+  process.env.CURSOR_DATA_DIR,
+  join(HOME, 'Library', 'Application Support', 'Cursor', 'User', 'workspaceStorage'),
+  join(HOME, '.config', 'Cursor', 'User', 'workspaceStorage'),
+].filter(Boolean)
+
+export const AGENT_ID    = 'cursor'
+export const AGENT_LABEL = 'Cursor'
+export const AGENT_COLOR = '#707070'
+
+export function isInstalled() { return DATA_DIRS.some(d => existsSync(d)) }
+
+export async function loadSessions() {
+  const items = []
+  const walk = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name === 'chat.json') {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp   = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({
+            agent: AGENT_ID, agentLabel: AGENT_LABEL,
+            path: full, sessionId: basename(full, '.jsonl'),
+            title: title || fileTitle(full), titleSource: tsrc || 'filename',
+            project: projName(pp), projectPath: pp,
+            date, dateLabel: fmtDate(date),
+            size, sizeLabel: humanSize(size),
+            filename: e.name, msgCount: objs.length,
+          })
+        }
+      }
+    } catch {}
+  }
+  DATA_DIRS.forEach(walk)
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/droid.js

@@ -0,0 +1,38 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import { readLimited, parseJsonl, pathSize, humanSize, ignored, titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate } from './utils.js'
+
+const HOME     = homedir()
+const DATA_DIR = process.env.DROID_DATA_DIR || join(HOME, '.droid')
+
+export const AGENT_ID    = 'droid'
+export const AGENT_LABEL = 'Droid'
+export const AGENT_COLOR = '#888'
+
+export function isInstalled() { return existsSync(DATA_DIR) }
+
+export async function loadSessions() {
+  const items = []
+  const walk = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name.endsWith('.json')) {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({ agent: AGENT_ID, agentLabel: AGENT_LABEL, path: full, sessionId: basename(full, e.name.endsWith('.jsonl') ? '.jsonl' : '.json'), title: title || fileTitle(full), titleSource: tsrc || 'filename', project: projName(pp), projectPath: pp, date, dateLabel: fmtDate(date), size, sizeLabel: humanSize(size), filename: e.name, msgCount: objs.length })
+        }
+      }
+    } catch {}
+  }
+  walk(DATA_DIR)
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/gemini.js

@@ -0,0 +1,50 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import {
+  readLimited, parseJsonl, pathSize, humanSize, ignored,
+  titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate,
+} from './utils.js'
+
+const HOME     = homedir()
+const DATA_DIR = process.env.GEMINI_DATA_DIR ||
+                 join(HOME, '.gemini')
+
+export const AGENT_ID    = 'gemini'
+export const AGENT_LABEL = 'Gemini CLI'
+export const AGENT_COLOR = '#808080'
+
+export function isInstalled() { return existsSync(DATA_DIR) }
+
+export async function loadSessions() {
+  const items = []
+  const walk = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name.endsWith('.json')) {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp   = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({
+            agent: AGENT_ID, agentLabel: AGENT_LABEL,
+            path: full, sessionId: basename(full, e.name.endsWith('.jsonl') ? '.jsonl' : '.json'),
+            title: title || fileTitle(full), titleSource: tsrc || 'filename',
+            project: projName(pp), projectPath: pp,
+            date, dateLabel: fmtDate(date),
+            size, sizeLabel: humanSize(size),
+            filename: e.name, msgCount: objs.length,
+          })
+        }
+      }
+    } catch {}
+  }
+  walk(DATA_DIR)
+  return items.sort((a,b) => b.date - a.date)
+}

package/src/agents/goose.js

@@ -0,0 +1,52 @@
+import { homedir } from 'node:os'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, basename } from 'node:path'
+import {
+  readLimited, parseJsonl, pathSize, humanSize, ignored,
+  titleFromObjs, fileTitle, dateFromPath, projName, guessProj, fmtDate,
+} from './utils.js'
+
+const HOME      = homedir()
+const DATA_DIR  = process.env.GOOSE_PATH_ROOT ||
+                  process.env.GOOSE_DATA_DIR   ||
+                  join(HOME, '.local', 'share', 'goose')
+const SESS_DIRS = [join(DATA_DIR, 'sessions'), DATA_DIR]
+
+export const AGENT_ID    = 'goose'
+export const AGENT_LABEL = 'Goose'
+export const AGENT_COLOR = '#909090'
+
+export function isInstalled() { return existsSync(DATA_DIR) }
+
+export async function loadSessions() {
+  const items = []
+  const walk = dir => {
+    if (!existsSync(dir)) return
+    try {
+      for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name)
+        if (ignored(full)) continue
+        if (e.isDirectory()) walk(full)
+        else if (e.name.endsWith('.jsonl') || e.name.endsWith('.json')) {
+          const text = readLimited(full)
+          const objs = parseJsonl(text)
+          const [title, tsrc] = titleFromObjs(objs)
+          const pp   = guessProj(text) || 'Unknown'
+          const date = dateFromPath(full)
+          const size = pathSize(full)
+          items.push({
+            agent: AGENT_ID, agentLabel: AGENT_LABEL,
+            path: full, sessionId: basename(full, e.name.endsWith('.jsonl') ? '.jsonl' : '.json'),
+            title: title || fileTitle(full), titleSource: tsrc || 'filename',
+            project: projName(pp), projectPath: pp,
+            date, dateLabel: fmtDate(date),
+            size, sizeLabel: humanSize(size),
+            filename: e.name, msgCount: objs.length,
+          })
+        }
+      }
+    } catch {}
+  }
+  SESS_DIRS.forEach(walk)
+  return items.sort((a,b) => b.date - a.date)
+}