@oh-my-pi/pi-coding-agent 12.1.0 → 12.2.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 ## [Unreleased]
 
+## [12.2.0] - 2026-02-13
+
+### Added
+
+- Added `providerSessionState` property to AgentSession for managing provider-scoped transport and session caches
+- Added automatic cleanup of provider session state resources on session disposal
+- Added `providers.openaiWebsockets` setting to prefer websocket transport for OpenAI Codex models
+- Added provider details display in session info showing authentication mode, transport, and connection settings
+- Added automatic prewarm of OpenAI Codex websocket connections on session creation for improved performance
+- Added real-time authentication validation in OAuth provider selector with visual status indicators (checking, valid, invalid)
+- Added `validateAuth` and `requestRender` options to OAuthSelectorComponent for custom authentication validation and UI refresh callbacks
+
+### Changed
+
+- Changed `providers.openaiWebsockets` setting from boolean to enum with values "auto", "off", "on" for more granular websocket policy control (auto uses model defaults, on forces websocket, off disables it)
+- Enhanced provider details display to include live provider session state information
+- Enhanced session info output to display active provider configuration and authentication details
+- Replaced `process.cwd()` with `getProjectDir()` throughout codebase for improved project directory detection and handling
+- Made `SessionManager.list()` async to support asynchronous session discovery operations
+- Preserved internal whitespace and indentation in bash command normalization to support heredocs and indentation-sensitive scripts
+- Improved git context loading performance with configurable timeouts and parallel status/commit queries
+- Enhanced git context reliability with better error handling for timeout and command failures
+- Changed OAuth provider selector to display live authentication status instead of static login state
+- Changed logout flow to refresh OAuth provider authentication state before showing selector
+
+### Fixed
+
+- Improved error reporting in fetch tool to include HTTP status codes when URL fetching fails
+- Fixed fetch tool to preserve actual response metadata (finalUrl, contentType) instead of defaults when requests fail
+
 ## [12.1.0] - 2026-02-13
 
 ### Added

package/examples/sdk/11-sessions.ts

@@ -25,7 +25,7 @@ if (modelFallbackMessage) console.log("Note:", modelFallbackMessage);
 console.log("Continued session:", continued.sessionFile);
 
 // List and open specific session
-const sessions = SessionManager.list(process.cwd());
+const sessions = await SessionManager.list(process.cwd());
 console.log(`\nFound ${sessions.length} sessions:`);
 for (const info of sessions.slice(0, 3)) {
 	console.log(`  ${info.id.slice(0, 8)}… - "${info.firstMessage.slice(0, 30)}…"`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "12.1.0",
+	"version": "12.2.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"bin": {
@@ -84,12 +84,12 @@
 	},
 	"dependencies": {
 		"@mozilla/readability": "0.6.0",
-		"@oh-my-pi/omp-stats": "12.1.0",
-		"@oh-my-pi/pi-agent-core": "12.1.0",
-		"@oh-my-pi/pi-ai": "12.1.0",
-		"@oh-my-pi/pi-natives": "12.1.0",
-		"@oh-my-pi/pi-tui": "12.1.0",
-		"@oh-my-pi/pi-utils": "12.1.0",
+		"@oh-my-pi/omp-stats": "12.2.0",
+		"@oh-my-pi/pi-agent-core": "12.2.0",
+		"@oh-my-pi/pi-ai": "12.2.0",
+		"@oh-my-pi/pi-natives": "12.2.0",
+		"@oh-my-pi/pi-tui": "12.2.0",
+		"@oh-my-pi/pi-utils": "12.2.0",
 		"@sinclair/typebox": "^0.34.48",
 		"@xterm/headless": "^6.0.0",
 		"ajv": "^8.17.1",
@@ -119,14 +119,19 @@
 		"tui",
 		"agent"
 	],
-	"author": "Mario Zechner",
+	"author": "Can Bölük",
+	"contributors": ["Mario Zechner"],
 	"license": "MIT",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/can1357/oh-my-pi.git",
 		"directory": "packages/coding-agent"
 	},
-	"engines": {
-		"bun": ">=1.3.7"
-	}
+	"homepage": "https://github.com/can1357/oh-my-pi",
+	"bugs": {
+	"url": "https://github.com/can1357/oh-my-pi/issues"
+},
+"engines": {
+	"bun": ">=1.3.7"
+}
 }

package/src/capability/index.ts

@@ -9,6 +9,7 @@
 import * as os from "node:os";
 import * as path from "node:path";
 import { $env } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 
 /** Conditional startup debug prints (stderr) when PI_DEBUG_STARTUP is set */
 const debugStartup = $env.PI_DEBUG_STARTUP ? (stage: string) => process.stderr.write(`[startup] ${stage}\n`) : () => {};
@@ -221,7 +222,7 @@ export async function loadCapability<T>(capabilityId: string, options: LoadOptio
 		throw new Error(`Unknown capability: "${capabilityId}"`);
 	}
 
-	const cwd = options.cwd ?? process.cwd();
+	const cwd = options.cwd ?? getProjectDir();
 	const home = os.homedir();
 	const ctx: LoadContext = { cwd, home };
 	const providers = filterProviders(capability, options);

package/src/capability/types.ts

@@ -62,7 +62,7 @@ export interface LoadOptions {
 	providers?: string[];
 	/** Exclude these providers (by ID). Default: none */
 	excludeProviders?: string[];
-	/** Custom cwd. Default: process.cwd() */
+	/** Custom cwd. Default: getProjectDir() */
 	cwd?: string;
 	/** Include items even if they fail validation. Default: false */
 	includeInvalid?: boolean;

package/src/cli/file-processor.ts

@@ -5,6 +5,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { isEnoent } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import chalk from "chalk";
 import { resolveReadPath } from "../tools/path-utils";
 import { formatSize } from "../tools/truncate";
@@ -34,7 +35,7 @@ export async function processFileArguments(fileArgs: string[], options?: Process
 
 	for (const fileArg of fileArgs) {
 		// Expand and resolve path (handles ~ expansion and macOS screenshot Unicode spaces)
-		const absolutePath = path.resolve(resolveReadPath(fileArg, process.cwd()));
+		const absolutePath = path.resolve(resolveReadPath(fileArg, getProjectDir()));
 
 		const stat = fs.statSync(absolutePath, { throwIfNoEntry: false });
 		if (!stat) {

package/src/cli/shell-cli.ts

@@ -6,7 +6,7 @@
 import * as path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { Shell } from "@oh-my-pi/pi-natives";
-import { APP_NAME } from "@oh-my-pi/pi-utils/dirs";
+import { APP_NAME, getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import chalk from "chalk";
 import { Settings } from "../config/settings";
 import { getOrCreateSnapshot } from "../utils/shell-snapshot";
@@ -47,7 +47,7 @@ export async function runShellCommand(cmd: ShellCommandArgs): Promise<void> {
 		process.exit(1);
 	}
 
-	const cwd = cmd.cwd ? path.resolve(cmd.cwd) : process.cwd();
+	const cwd = cmd.cwd ? path.resolve(cmd.cwd) : getProjectDir();
 	const settings = await Settings.init({ cwd });
 	const { shell, env: shellEnv } = settings.getShellConfig();
 	const snapshotPath = cmd.noSnapshot || !shell.includes("bash") ? null : await getOrCreateSnapshot(shell, shellEnv);

package/src/commit/agentic/index.ts

@@ -1,6 +1,7 @@
 import * as path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { $env } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { applyChangelogProposals } from "../../commit/changelog";
 import { detectChangelogBoundaries } from "../../commit/changelog/detect";
 import { parseUnreleasedSection } from "../../commit/changelog/parse";
@@ -26,7 +27,7 @@ interface CommitExecutionContext {
 }
 
 export async function runAgenticCommit(args: CommitCommandArgs): Promise<void> {
-	const cwd = process.cwd();
+	const cwd = getProjectDir();
 	const git = new ControlledGit(cwd);
 	const [settings, authStorage] = await Promise.all([Settings.init({ cwd }), discoverAuthStorage()]);
 

package/src/commit/pipeline.ts

@@ -1,6 +1,7 @@
 import * as path from "node:path";
 import type { Api, Model } from "@oh-my-pi/pi-ai";
 import { logger } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { ModelRegistry } from "../config/model-registry";
 import { renderPromptTemplate } from "../config/prompt-templates";
 import { Settings } from "../config/settings";
@@ -38,7 +39,7 @@ export async function runCommitCommand(args: CommitCommandArgs): Promise<void> {
 }
 
 async function runLegacyCommitCommand(args: CommitCommandArgs): Promise<void> {
-	const cwd = process.cwd();
+	const cwd = getProjectDir();
 	const settings = await Settings.init();
 	const commitSettings = settings.getGroup("commit");
 	const authStorage = await discoverAuthStorage();

package/src/config/prompt-templates.ts

@@ -1,7 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { logger } from "@oh-my-pi/pi-utils";
-import { getProjectPromptsDir, getPromptsDir } from "@oh-my-pi/pi-utils/dirs";
+import { getProjectDir, getProjectPromptsDir, getPromptsDir } from "@oh-my-pi/pi-utils/dirs";
 import Handlebars from "handlebars";
 import { computeLineHash } from "../patch/hashline";
 import { jtdToTypeScript } from "../tools/jtd-to-typescript";
@@ -459,7 +459,7 @@ async function loadTemplatesFromDir(
 }
 
 export interface LoadPromptTemplatesOptions {
-	/** Working directory for project-local templates. Default: process.cwd() */
+	/** Working directory for project-local templates. Default: getProjectDir() */
 	cwd?: string;
 	/** Agent config directory for global templates. Default: from getPromptsDir() */
 	agentDir?: string;
@@ -471,7 +471,7 @@ export interface LoadPromptTemplatesOptions {
  * 2. Project: cwd/.omp/prompts/
  */
 export async function loadPromptTemplates(options: LoadPromptTemplatesOptions = {}): Promise<PromptTemplate[]> {
-	const resolvedCwd = options.cwd ?? process.cwd();
+	const resolvedCwd = options.cwd ?? getProjectDir();
 	const resolvedAgentDir = options.agentDir ?? getPromptsDir();
 
 	const templates: PromptTemplate[] = [];

package/src/config/settings-schema.ts

@@ -592,6 +592,17 @@ export const SETTINGS_SCHEMA = {
 			submenu: true,
 		},
 	},
+	"providers.openaiWebsockets": {
+		type: "enum",
+		values: ["auto", "off", "on"] as const,
+		default: "auto",
+		ui: {
+			tab: "services",
+			label: "OpenAI websockets",
+			description: "Websocket policy for OpenAI Codex models (auto uses model defaults, on forces, off disables)",
+			submenu: true,
+		},
+	},
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Exa settings

package/src/config/settings.ts

@@ -14,7 +14,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { isEnoent, logger, procmgr } from "@oh-my-pi/pi-utils";
-import { getAgentDbPath, getAgentDir } from "@oh-my-pi/pi-utils/dirs";
+import { getAgentDbPath, getAgentDir, getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { YAML } from "bun";
 import { type Settings as SettingsCapabilityItem, settingsCapability } from "../capability/settings";
 import type { ModelRole } from "../config/model-registry";
@@ -146,7 +146,7 @@ export class Settings {
 	#persist: boolean;
 
 	private constructor(options: SettingsOptions = {}) {
-		this.#cwd = path.normalize(options.cwd ?? process.cwd());
+		this.#cwd = path.normalize(options.cwd ?? getProjectDir());
 		this.#agentDir = path.normalize(options.agentDir ?? getAgentDir());
 		this.#configPath = options.inMemory ? null : path.join(this.#agentDir, "config.yml");
 		this.#persist = !options.inMemory;

package/src/config.ts

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import { isEnoent, logger } from "@oh-my-pi/pi-utils";
-import { CONFIG_DIR_NAME, getAgentDir } from "@oh-my-pi/pi-utils/dirs";
+import { CONFIG_DIR_NAME, getAgentDir, getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import type { TSchema } from "@sinclair/typebox";
 import { Value } from "@sinclair/typebox/value";
 import { Ajv, type ErrorObject, type ValidateFunction } from "ajv";
@@ -39,8 +39,8 @@ export function getPackageDir(): string {
 		}
 		dir = path.dirname(dir);
 	}
-	// Fallback to cwd (docs/examples won't be found, but that's fine)
-	return process.cwd();
+	// Fallback to project dir (docs/examples won't be found, but that's fine)
+	return getProjectDir();
 }
 
 /** Get path to CHANGELOG.md (optional, may not exist in binary) */
@@ -273,7 +273,7 @@ export interface GetConfigDirsOptions {
 	user?: boolean;
 	/** Include project-level directories (.omp/...). Default: true */
 	project?: boolean;
-	/** Current working directory for project paths. Default: process.cwd() */
+	/** Current working directory for project paths. Default: getProjectDir() */
 	cwd?: string;
 	/** Only return directories that exist. Default: false */
 	existingOnly?: boolean;
@@ -296,7 +296,7 @@ export interface GetConfigDirsOptions {
  * getConfigDirs("skills", { user: false, existingOnly: true })
  */
 export function getConfigDirs(subpath: string, options: GetConfigDirsOptions = {}): ConfigDirEntry[] {
-	const { user = true, project = true, cwd = process.cwd(), existingOnly = false } = options;
+	const { user = true, project = true, cwd = getProjectDir(), existingOnly = false } = options;
 	const results: ConfigDirEntry[] = [];
 
 	// User-level directories (highest priority)
@@ -382,7 +382,7 @@ export function findConfigFileWithMeta(
  * Returns one entry per config base (.omp, .claude) - the nearest one found.
  * Results are in priority order (highest first).
  */
-export function findAllNearestProjectConfigDirs(subpath: string, cwd: string = process.cwd()): ConfigDirEntry[] {
+export function findAllNearestProjectConfigDirs(subpath: string, cwd: string = getProjectDir()): ConfigDirEntry[] {
 	const results: ConfigDirEntry[] = [];
 	const foundBases = new Set<string>();
 

package/src/debug/system-info.ts

@@ -2,7 +2,7 @@
  * System information collection for debug reports.
  */
 import * as os from "node:os";
-import { VERSION } from "@oh-my-pi/pi-utils/dirs";
+import { getProjectDir, VERSION } from "@oh-my-pi/pi-utils/dirs";
 
 export interface SystemInfo {
 	os: string;
@@ -65,7 +65,7 @@ export async function collectSystemInfo(): Promise<SystemInfo> {
 			bun: Bun.version,
 			node: process.version,
 		},
-		cwd: process.cwd(),
+		cwd: getProjectDir(),
 		shell,
 		terminal,
 	};

package/src/extensibility/custom-commands/loader.ts

@@ -8,7 +8,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import * as piCodingAgent from "@oh-my-pi/pi-coding-agent";
 import { isEnoent, logger } from "@oh-my-pi/pi-utils";
-import { getAgentDir } from "@oh-my-pi/pi-utils/dirs";
+import { getAgentDir, getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import * as typebox from "@sinclair/typebox";
 import { getConfigDirs } from "../../config";
 import { execCommand } from "../../exec/exec";
@@ -62,7 +62,7 @@ async function loadCommandModule(
 }
 
 export interface DiscoverCustomCommandsOptions {
-	/** Current working directory. Default: process.cwd() */
+	/** Current working directory. Default: getProjectDir() */
 	cwd?: string;
 	/** Agent config directory. Default: from getAgentDir() */
 	agentDir?: string;
@@ -80,7 +80,7 @@ export interface DiscoverCustomCommandsResult {
 export async function discoverCustomCommands(
 	options: DiscoverCustomCommandsOptions = {},
 ): Promise<DiscoverCustomCommandsResult> {
-	const cwd = options.cwd ?? process.cwd();
+	const cwd = options.cwd ?? getProjectDir();
 	const agentDir = options.agentDir ?? getAgentDir();
 	const paths: Array<{ path: string; source: CustomCommandSource }> = [];
 	const seen = new Set<string>();
@@ -136,7 +136,7 @@ export async function discoverCustomCommands(
 }
 
 export interface LoadCustomCommandsOptions {
-	/** Current working directory. Default: process.cwd() */
+	/** Current working directory. Default: getProjectDir() */
 	cwd?: string;
 	/** Agent config directory. Default: from getAgentDir() */
 	agentDir?: string;
@@ -163,7 +163,7 @@ function loadBundledCommands(sharedApi: CustomCommandAPI): LoadedCustomCommand[]
  * Discover and load custom commands from standard locations.
  */
 export async function loadCustomCommands(options: LoadCustomCommandsOptions = {}): Promise<CustomCommandsLoadResult> {
-	const cwd = options.cwd ?? process.cwd();
+	const cwd = options.cwd ?? getProjectDir();
 	const agentDir = options.agentDir ?? getAgentDir();
 
 	const { paths } = await discoverCustomCommands({ cwd, agentDir });

package/src/extensibility/plugins/installer.ts

@@ -1,7 +1,7 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { isEnoent } from "@oh-my-pi/pi-utils";
-import { getAgentDir } from "@oh-my-pi/pi-utils/dirs";
+import { getAgentDir, getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import type { InstalledPlugin } from "./types";
 
 const PLUGINS_DIR = path.join(getAgentDir(), "plugins");
@@ -131,7 +131,7 @@ export async function listPlugins(): Promise<InstalledPlugin[]> {
 }
 
 export async function linkPlugin(localPath: string): Promise<void> {
-	const cwd = process.cwd();
+	const cwd = getProjectDir();
 	const absolutePath = path.resolve(cwd, localPath);
 
 	// Validate that resolved path is within cwd to prevent path traversal

package/src/extensibility/plugins/manager.ts

@@ -6,6 +6,7 @@ import {
 	getPluginsLockfile,
 	getPluginsNodeModules,
 	getPluginsPackageJson,
+	getProjectDir,
 	getProjectPluginOverridesPath,
 } from "@oh-my-pi/pi-utils/dirs";
 import { extractPackageName, parsePluginSpec } from "./parser";
@@ -50,7 +51,7 @@ export class PluginManager {
 	#runtimeConfig: PluginRuntimeConfig | null = null;
 	#cwd: string;
 
-	constructor(cwd: string = process.cwd()) {
+	constructor(cwd: string = getProjectDir()) {
 		this.#cwd = cwd;
 	}
 

package/src/extensibility/skills.ts

@@ -2,6 +2,7 @@ import * as fs from "node:fs/promises";
 import * as os from "node:os";
 import * as path from "node:path";
 import { logger } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { skillCapability } from "../capability/skill";
 import type { SourceMeta } from "../capability/types";
 import type { SkillsSettings } from "../config/settings";
@@ -207,7 +208,7 @@ async function scanDirectoryForSkills(dir: string): Promise<LoadSkillsResult> {
 }
 
 export interface LoadSkillsOptions extends SkillsSettings {
-	/** Working directory for project-local skills. Default: process.cwd() */
+	/** Working directory for project-local skills. Default: getProjectDir() */
 	cwd?: string;
 }
 
@@ -217,7 +218,7 @@ export interface LoadSkillsOptions extends SkillsSettings {
  */
 export async function loadSkills(options: LoadSkillsOptions = {}): Promise<LoadSkillsResult> {
 	const {
-		cwd = process.cwd(),
+		cwd = getProjectDir(),
 		enabled = true,
 		enableCodexUser = true,
 		enableClaudeUser = true,

package/src/extensibility/slash-commands.ts

@@ -281,7 +281,7 @@ export function substituteArgs(content: string, args: string[]): string {
 }
 
 export interface LoadSlashCommandsOptions {
-	/** Working directory for project-local commands. Default: process.cwd() */
+	/** Working directory for project-local commands. Default: getProjectDir() */
 	cwd?: string;
 }
 

package/src/ipy/executor.ts

@@ -1,6 +1,6 @@
 import * as path from "node:path";
 import { $env, isEnoent, logger } from "@oh-my-pi/pi-utils";
-import { getAgentDir } from "@oh-my-pi/pi-utils/dirs";
+import { getAgentDir, getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { OutputSink } from "../session/streaming-output";
 import { time } from "../utils/timings";
 import { shutdownSharedGateway } from "./gateway-coordinator";
@@ -523,7 +523,7 @@ export async function executePythonWithKernel(
 }
 
 export async function executePython(code: string, options?: PythonExecutorOptions): Promise<PythonResult> {
-	const cwd = options?.cwd ?? process.cwd();
+	const cwd = options?.cwd ?? getProjectDir();
 	await ensureKernelAvailable(cwd);
 
 	const kernelMode = options?.kernelMode ?? "session";

package/src/ipy/modules.ts

@@ -1,6 +1,6 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { getAgentModulesDir, getProjectModulesDir } from "@oh-my-pi/pi-utils/dirs";
+import { getAgentModulesDir, getProjectDir, getProjectModulesDir } from "@oh-my-pi/pi-utils/dirs";
 
 export type PythonModuleSource = "user" | "project";
 
@@ -24,7 +24,7 @@ export interface PythonModuleExecutor {
 }
 
 export interface DiscoverPythonModulesOptions {
-	/** Working directory for project-level modules. Default: process.cwd() */
+	/** Working directory for project-level modules. Default: getProjectDir() */
 	cwd?: string;
 	/** Agent directory for user-level modules. Default: from getAgentDir() */
 	agentDir?: string;
@@ -65,7 +65,7 @@ async function readModuleContent(candidate: ModuleCandidate): Promise<PythonModu
  * Discover Python prelude extension modules from user and project directories.
  */
 export async function discoverPythonModules(options: DiscoverPythonModulesOptions = {}): Promise<PythonModuleEntry[]> {
-	const cwd = options.cwd ?? process.cwd();
+	const cwd = options.cwd ?? getProjectDir();
 
 	const userDir = getAgentModulesDir(options.agentDir);
 	const projectDir = getProjectModulesDir(cwd);

package/src/main.ts

@@ -4,13 +4,15 @@
  * This file handles CLI argument parsing and translates them into
  * createAgentSession() options. The SDK does the heavy lifting.
  */
+
+import { realpathSync } from "node:fs";
 import * as fs from "node:fs/promises";
 import * as os from "node:os";
 import * as path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { type ImageContent, supportsXhigh } from "@oh-my-pi/pi-ai";
 import { $env, postmortem } from "@oh-my-pi/pi-utils";
-import { VERSION } from "@oh-my-pi/pi-utils/dirs";
+import { getProjectDir, setProjectDir, VERSION } from "@oh-my-pi/pi-utils/dirs";
 import chalk from "chalk";
 import type { Args } from "./cli/args";
 import { processFileArguments } from "./cli/file-processor";
@@ -278,11 +280,11 @@ async function maybeAutoChdir(parsed: Args): Promise<void> {
 	}
 
 	const normalizePath = (value: string) => {
-		const resolved = path.resolve(value);
+		const resolved = realpathSync(path.resolve(value));
 		return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 	};
 
-	const cwd = normalizePath(process.cwd());
+	const cwd = normalizePath(getProjectDir());
 	const normalizedHome = normalizePath(home);
 	if (cwd !== normalizedHome) {
 		return;
@@ -303,7 +305,7 @@ async function maybeAutoChdir(parsed: Args): Promise<void> {
 			if (!(await isDirectory(candidate))) {
 				continue;
 			}
-			process.chdir(candidate);
+			setProjectDir(candidate);
 			return;
 		} catch {
 			// Try next candidate.
@@ -313,7 +315,7 @@ async function maybeAutoChdir(parsed: Args): Promise<void> {
 	try {
 		const fallback = os.tmpdir();
 		if (fallback && normalizePath(fallback) !== cwd && (await isDirectory(fallback))) {
-			process.chdir(fallback);
+			setProjectDir(fallback);
 		}
 	} catch {
 		// Ignore fallback errors.
@@ -355,7 +357,7 @@ async function buildSessionOptions(
 	modelRegistry: ModelRegistry,
 ): Promise<CreateAgentSessionOptions> {
 	const options: CreateAgentSessionOptions = {
-		cwd: parsed.cwd ?? process.cwd(),
+		cwd: parsed.cwd ?? getProjectDir(),
 	};
 
 	// Auto-discover SYSTEM.md if no CLI system prompt provided
@@ -524,7 +526,7 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 		process.exit(1);
 	}
 
-	const cwd = process.cwd();
+	const cwd = getProjectDir();
 	await Settings.init({ cwd });
 	debugStartup("main:Settings.init");
 	time("Settings.init");

package/src/mcp/transports/stdio.ts

@@ -6,6 +6,7 @@
  */
 
 import { readJsonl } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { type Subprocess, spawn } from "bun";
 import type { JsonRpcResponse, MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../../mcp/types";
 
@@ -54,7 +55,7 @@ export class StdioTransport implements MCPTransport {
 
 		this.#process = spawn({
 			cmd: [this.config.command, ...args],
-			cwd: this.config.cwd ?? process.cwd(),
+			cwd: this.config.cwd ?? getProjectDir(),
 			env,
 			stdin: "pipe",
 			stdout: "pipe",

package/src/modes/components/footer.ts

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import type { AssistantMessage } from "@oh-my-pi/pi-ai";
 import { type Component, padding, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
 import { isEnoent } from "@oh-my-pi/pi-utils";
+import { getProjectDir } from "@oh-my-pi/pi-utils/dirs";
 import { theme } from "../../modes/theme/theme";
 import type { AgentSession } from "../../session/agent-session";
 import { shortenPath } from "../../tools/render-utils";
@@ -21,7 +22,7 @@ function sanitizeStatusText(text: string): string {
 
 /** Find the git root by walking up from cwd. Returns path and content of .git/HEAD if found. */
 async function findGitHeadPath(): Promise<{ path: string; content: string } | null> {
-	let dir = process.cwd();
+	let dir = getProjectDir();
 	while (true) {
 		const gitHeadPath = path.join(dir, ".git", "HEAD");
 		try {
@@ -201,7 +202,7 @@ export class FooterComponent implements Component {
 		};
 
 		// Replace home directory with ~
-		let pwd = shortenPath(process.cwd());
+		let pwd = shortenPath(getProjectDir());
 
 		// Add git branch if available
 		const branch = this.#getCurrentBranch();