@phren/cli/dist/home-paths.js

Knowledge layer for AI agents - CLI, MCP server, and data layer

// The user's home and the agent config directories under it. Node builtins
// only: the Hook bundle reads these on cold start.
import { homedir } from "node:os";
import path from "node:path";
/** The user's home: an absolute `HOME` when set (tests and POSIX), else
 * `USERPROFILE`, else the OS's answer. `os.homedir()` ignores `HOME` on Windows. */
export function homeDir(env = process.env) {
    return env.HOME && path.isAbsolute(env.HOME) ? env.HOME : env.USERPROFILE || homedir();
}
function configuredDir(value, env, fallback) {
    const configured = value?.trim();
    return configured ? path.resolve(configured) : path.join(homeDir(env), fallback);
}
/** Claude Code's config directory: `CLAUDE_CONFIG_DIR`, else `~/.claude`. */
export function claudeConfigDir(env = process.env) {
    return configuredDir(env.CLAUDE_CONFIG_DIR, env, ".claude");
}
/** Codex's home: `CODEX_HOME`, else `~/.codex`. */
export function codexHome(env = process.env) {
    return configuredDir(env.CODEX_HOME, env, ".codex");
}
/** Copilot CLI's home: `COPILOT_HOME`, else `~/.copilot`. */
export function copilotHome(env = process.env) {
    return configuredDir(env.COPILOT_HOME, env, ".copilot");
}