Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

1.2 KB
Raw Blame
/**
 * Path helpers for locating Claude Code session JSONL files.
 *
 * Layout on disk (written by the local `claude` CLI):
 *   {CLAUDE_PROJECTS_DIR}/<mangled-workdir>/<sessionId>.jsonl
 *
 * The `<mangled-workdir>` is the absolute project dir with every non-alphanumeric
 * character replaced by `-`. It is lossy (not reversible), so we derive the real
 * working directory from the `cwd` field carried on the JSONL lines instead.
 *
 * This module is intentionally self-contained — machine-adapter does not import from
 * anything outside this package.
 */

import { basename } from 'path'

/** True for a session JSONL we want to surface (excludes subagent mirrors). */
export function isSessionFile(filePath: string): boolean {
  const name = basename(filePath)
  return name.endsWith('.jsonl') && !name.startsWith('agent-')
}

/** True for a path inside a `.codex/` engine subdir (skipped for now). */
export function isCodexPath(filePath: string): boolean {
  return filePath.includes('/.codex/') || filePath.includes('\\.codex\\')
}

/** The sessionId is the JSONL filename without its extension. */
export function sessionIdFromFile(filePath: string): string {
  return basename(filePath).replace(/\.jsonl$/, '')
}