@oh-my-pi/pi-coding-agent 12.4.0 → 12.5.0

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 ## [Unreleased]
 
+## [12.5.0] - 2026-02-15
+### Breaking Changes
+
+- Replaced `theme` setting with `theme.dark` and `theme.light` (auto-migrated)
+
+### Added
+
+- Added `previewTheme()` function for non-destructive theme preview during settings browsing
+- Added animated microphone icon with color cycling during voice recording
+- Added support for discovering skills via symbolic links in skill directories
+- Added `abort_and_prompt` RPC command for atomic abort-and-reprompt without race conditions ([#357](https://github.com/can1357/oh-my-pi/pull/357))
+- Added automatic dark/light theme switching via SIGWINCH with separate `theme.dark`/`theme.light` settings, replacing the single `theme` setting ([#65](https://github.com/can1357/oh-my-pi/issues/65))
+- Added speech-to-text (STT) feature with `Alt+H` keybinding and `/stt` slash command
+- Added cross-platform audio recording: SoX, FFmpeg, arecord (Linux), PowerShell mciSendString (Windows fallback)
+- Added recording tool fallback chain — automatically tries each available tool in order
+- Added Python openai-whisper integration for transcription with automatic `pip install`
+- Added custom WAV-to-numpy pipeline in `transcribe.py` bypassing ffmpeg dependency
+- Added STT settings: `stt.enabled`, `stt.language`, `stt.modelName`
+- Added STT status line segment showing recording/transcribing state
+- Added `/stt` command with `on`, `off`, `status`, `setup` subcommands
+- Added auto-download of recording tools (best-effort FFmpeg via winget on Windows)
+- Added interactive debug log viewer with selection, copy, and expand/collapse controls
+- Added inline filtering and count display to the debug log viewer
+- Added pid filter toggle and load-older pagination controls to the debug log viewer
+- Enabled loading older debug logs from archived files in viewer
+- Added file hyperlinks for debug report paths in viewer
+
+### Changed
+
+- Changed theme preview to support asynchronous theme loading with request deduplication to prevent race conditions
+- Enhanced theme preview cancellation to restore the previously active theme instead of the last selected value
+- Refactored file discovery to use native glob with gitignore support instead of manual directory traversal, improving performance and consistency
+- Updated dependencies: glob to ^13.0.3, marked to ^17.0.2, puppeteer to ^24.37.3
+- Optimized skill and file discovery using native glob (Rust ignore crate) — reduces startup time by ~80% (1254ms → 6ms for skills)
+- Enhanced hashline reference parsing to handle prefixes like `>>>` and `>>` in line references
+- Strengthened type safety in hashline edit formatting with defensive null checks for incomplete edits
+- Changed STT status messages to display via state change callbacks instead of explicit status calls
+- Changed cursor visibility behavior during voice recording to hide hardware and terminal cursors
+
+### Removed
+
+- Removed dedicated STT status line segment in favor of animated cursor-based feedback
+
+### Fixed
+
+- Fixed theme preview updates being applied out-of-order when rapidly browsing theme options
+- Fixed skill discovery to correctly extract skill names from directory paths when frontmatter name is missing
+- Fixed `session.abort()` not clearing `promptInFlight` flag due to microtask ordering, which blocked subsequent prompts
+- Sanitized debug log display to strip control codes, normalize tabs, and trim width
+
 ## [12.4.0] - 2026-02-14
 ### Changed
 
@@ -62,6 +112,7 @@
 - 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
 
+||||||| parent of a70a34c8b (fix(coding-agent/debug): Sanitized debug log rendering)
 ## [12.1.0] - 2026-02-13
 
 ### Added

package/docs/custom-tools.md

@@ -324,19 +324,34 @@ async execute(toolCallId, params, onUpdate, ctx, signal) {
 Tools can implement `onSession` to react to session changes:
 
 ```typescript
-interface CustomToolSessionEvent {
-	reason: "start" | "switch" | "branch" | "tree" | "shutdown";
-	previousSessionFile: string | undefined;
-}
+type CustomToolSessionEvent =
+	| { reason: "start" | "switch" | "branch" | "tree" | "shutdown"; previousSessionFile: string | undefined }
+	| { reason: "auto_compaction_start"; trigger: "threshold" | "overflow" }
+	| {
+			reason: "auto_compaction_end";
+			result: CompactionResult | undefined;
+			aborted: boolean;
+			willRetry: boolean;
+			errorMessage?: string;
+	  }
+	| { reason: "auto_retry_start"; attempt: number; maxAttempts: number; delayMs: number; errorMessage: string }
+	| { reason: "auto_retry_end"; success: boolean; attempt: number; finalError?: string }
+	| { reason: "ttsr_triggered"; rules: Rule[] }
+	| { reason: "todo_reminder"; todos: TodoItem[]; attempt: number; maxAttempts: number };
 ```
 
 **Reasons:**
-
-- `start`: Initial session load on startup
+- `start`: Initial session load (fresh start or resuming an existing session) - use to reconstruct state from session entries
 - `switch`: User started a new session (`/new`) or switched to a different session (`/resume`)
 - `branch`: User branched from a previous message (`/branch`)
 - `tree`: User navigated to a different point in the session tree (`/tree`)
 - `shutdown`: Process is exiting (Ctrl+C, Ctrl+D, or SIGTERM) - use to cleanup resources
+- `auto_compaction_start`: Auto-compaction kicked off (`threshold` or `overflow`)
+- `auto_compaction_end`: Auto-compaction finished (includes result/abort/error metadata)
+- `auto_retry_start`: Automatic retry scheduled after an assistant error
+- `auto_retry_end`: Automatic retry completed/failed/cancelled
+- `ttsr_triggered`: Time-travel stream rule interrupted generation
+- `todo_reminder`: Todo reminder fired with outstanding items
 
 To check if a session is fresh (no messages), use `ctx.sessionManager.getEntries().length === 0`.
 

package/docs/extensions.md

@@ -499,6 +499,26 @@ pi.on("turn_end", async (event, ctx) => {
 
 **Examples:** [plan-mode.ts](../examples/extensions/plan-mode.ts)
 
+#### Runtime reliability events
+
+Fired for internal recovery/continuation mechanics:
+
+- `auto_compaction_start` / `auto_compaction_end`
+- `auto_retry_start` / `auto_retry_end`
+- `ttsr_triggered`
+- `todo_reminder`
+
+```typescript
+pi.on("todo_reminder", async (event, _ctx) => {
+	// event.todos, event.attempt, event.maxAttempts
+});
+
+pi.on("auto_retry_start", async (event, _ctx) => {
+	// event.attempt, event.maxAttempts, event.delayMs, event.errorMessage
+});
+```
+
+
 #### context
 
 Fired before each LLM call. Modify messages non-destructively.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "12.4.0",
+	"version": "12.5.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"bin": {
@@ -78,31 +78,31 @@
 	"scripts": {
 		"check": "tsgo -p tsconfig.json",
 		"format-prompts": "bun scripts/format-prompts.ts",
-		"build:binary": "cd ../.. && bun --cwd=packages/natives run embed:native && bun build --compile --define PI_COMPILED=true --root . ./packages/coding-agent/src/cli.ts --outfile packages/coding-agent/dist/omp && bun --cwd=packages/natives run embed:native --reset",
+		"build:binary": "cd ../.. && bun --cwd=packages/stats scripts/generate-client-bundle.ts && bun --cwd=packages/natives run embed:native && bun build --compile --define PI_COMPILED=true --root . ./packages/coding-agent/src/cli.ts --outfile packages/coding-agent/dist/omp && bun --cwd=packages/natives run embed:native --reset && bun --cwd=packages/stats scripts/generate-client-bundle.ts --reset",
 		"generate-template": "bun scripts/generate-template.ts",
 		"test": "bun test"
 	},
 	"dependencies": {
 		"@mozilla/readability": "0.6.0",
-		"@oh-my-pi/omp-stats": "12.4.0",
-		"@oh-my-pi/pi-agent-core": "12.4.0",
-		"@oh-my-pi/pi-ai": "12.4.0",
-		"@oh-my-pi/pi-natives": "12.4.0",
-		"@oh-my-pi/pi-tui": "12.4.0",
-		"@oh-my-pi/pi-utils": "12.4.0",
+		"@oh-my-pi/omp-stats": "12.5.0",
+		"@oh-my-pi/pi-agent-core": "12.5.0",
+		"@oh-my-pi/pi-ai": "12.5.0",
+		"@oh-my-pi/pi-natives": "12.5.0",
+		"@oh-my-pi/pi-tui": "12.5.0",
+		"@oh-my-pi/pi-utils": "12.5.0",
 		"@sinclair/typebox": "^0.34.48",
 		"@xterm/headless": "^6.0.0",
-		"ajv": "^8.17.1",
+		"ajv": "^8.18.0",
 		"chalk": "^5.6.2",
 		"diff": "^8.0.3",
 		"file-type": "^21.3.0",
-		"glob": "^13.0.1",
+		"glob": "^13.0.3",
 		"handlebars": "^4.7.8",
 		"ignore": "^7.0.5",
 		"linkedom": "^0.18.12",
-		"marked": "^17.0.1",
+		"marked": "^17.0.2",
 		"node-html-parser": "^7.0.2",
-		"puppeteer": "^24.37.1",
+		"puppeteer": "^24.37.3",
 		"smol-toml": "^1.6.0",
 		"zod": "^4.3.6"
 	},

package/src/cli/setup-cli.ts

@@ -9,7 +9,7 @@ import { $ } from "bun";
 import chalk from "chalk";
 import { theme } from "../modes/theme/theme";
 
-export type SetupComponent = "python";
+export type SetupComponent = "python" | "stt";
 
 export interface SetupCommandArgs {
 	component: SetupComponent;
@@ -19,7 +19,7 @@ export interface SetupCommandArgs {
 	};
 }
 
-const VALID_COMPONENTS: SetupComponent[] = ["python"];
+const VALID_COMPONENTS: SetupComponent[] = ["python", "stt"];
 
 const PYTHON_PACKAGES = ["jupyter_kernel_gateway", "ipykernel"];
 const MANAGED_PYTHON_ENV = getPythonEnvDir();
@@ -206,6 +206,9 @@ export async function runSetupCommand(cmd: SetupCommandArgs): Promise<void> {
 		case "python":
 			await handlePythonSetup(cmd.flags);
 			break;
+		case "stt":
+			await handleSttSetup(cmd.flags);
+			break;
 	}
 }
 
@@ -292,6 +295,60 @@ async function handlePythonSetup(flags: { json?: boolean; check?: boolean }): Pr
 	}
 }
 
+async function handleSttSetup(flags: { json?: boolean; check?: boolean }): Promise<void> {
+	const { checkDependencies, formatDependencyStatus } = await import("../stt/setup");
+	const status = await checkDependencies();
+
+	if (flags.json) {
+		console.log(JSON.stringify(status, null, 2));
+		if (!status.recorder.available || !status.python.available || !status.whisper.available) process.exit(1);
+		return;
+	}
+
+	console.log(formatDependencyStatus(status));
+
+	if (status.recorder.available && status.python.available && status.whisper.available) {
+		console.log(chalk.green(`\n${theme.status.success} Speech-to-text is ready`));
+		return;
+	}
+
+	if (flags.check) {
+		process.exit(1);
+	}
+
+	if (!status.python.available) {
+		console.error(chalk.red(`\n${theme.status.error} Python not found`));
+		console.error(chalk.dim("Install Python 3.8+ and ensure it's in your PATH"));
+		process.exit(1);
+	}
+
+	if (!status.recorder.available) {
+		console.error(chalk.yellow(`\n${theme.status.warning} No recording tool found`));
+		console.error(chalk.dim(status.recorder.installHint));
+	}
+
+	if (!status.whisper.available) {
+		console.log(chalk.dim(`\nInstalling openai-whisper...`));
+		const { resolvePython } = await import("../stt/transcriber");
+		const pythonCmd = resolvePython()!;
+		const result = await $`${pythonCmd} -m pip install -q openai-whisper`.nothrow();
+		if (result.exitCode !== 0) {
+			console.error(chalk.red(`\n${theme.status.error} Failed to install openai-whisper`));
+			console.error(chalk.dim("Try manually: pip install openai-whisper"));
+			process.exit(1);
+		}
+	}
+
+	const recheck = await checkDependencies();
+	if (recheck.recorder.available && recheck.python.available && recheck.whisper.available) {
+		console.log(chalk.green(`\n${theme.status.success} Speech-to-text is ready`));
+	} else {
+		console.error(chalk.red(`\n${theme.status.error} Setup incomplete`));
+		console.log(formatDependencyStatus(recheck));
+		process.exit(1);
+	}
+}
+
 /**
  * Print setup command help.
  */
@@ -303,6 +360,7 @@ ${chalk.bold("Usage:")}
 
 ${chalk.bold("Components:")}
   python    Install Jupyter kernel dependencies for Python code execution
+  stt       Install speech-to-text dependencies (openai-whisper, recording tools)
             Packages: ${PYTHON_PACKAGES.join(", ")}
 
 ${chalk.bold("Options:")}
@@ -311,6 +369,8 @@ ${chalk.bold("Options:")}
 
 ${chalk.bold("Examples:")}
   ${APP_NAME} setup python           Install Python execution dependencies
+  ${APP_NAME} setup stt              Install speech-to-text dependencies
+  ${APP_NAME} setup stt --check      Check if STT dependencies are available
   ${APP_NAME} setup python --check   Check if Python execution is available
 `);
 }

package/src/commands/setup.ts

@@ -5,7 +5,7 @@ import { Args, Command, Flags, renderCommandHelp } from "@oh-my-pi/pi-utils/cli"
 import { runSetupCommand, type SetupCommandArgs, type SetupComponent } from "../cli/setup-cli";
 import { initTheme } from "../modes/theme/theme";
 
-const COMPONENTS: SetupComponent[] = ["python"];
+const COMPONENTS: SetupComponent[] = ["python", "stt"];
 
 export default class Setup extends Command {
 	static description = "Install dependencies for optional features";

package/src/config/keybindings.ts

@@ -35,7 +35,8 @@ export type AppAction =
 	| "newSession"
 	| "tree"
 	| "fork"
-	| "resume";
+	| "resume"
+	| "toggleSTT";
 
 /**
  * All configurable actions.
@@ -74,6 +75,7 @@ export const DEFAULT_APP_KEYBINDINGS: Record<AppAction, KeyId | KeyId[]> = {
 	tree: [],
 	fork: [],
 	resume: [],
+	toggleSTT: "alt+h",
 };
 
 /**
@@ -107,6 +109,7 @@ const APP_ACTIONS: AppAction[] = [
 	"tree",
 	"fork",
 	"resume",
+	"toggleSTT",
 ];
 
 function isAppAction(action: string): action is AppAction {

package/src/config/settings-schema.ts

@@ -7,7 +7,7 @@
  *
  * The Settings singleton provides type-safe path-based access:
  *   settings.get("compaction.enabled")  // => boolean
- *   settings.set("theme", "dark")       // sync, saves in background
+ *   settings.set("theme.dark", "titanium")  // sync, saves in background
  */
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -141,10 +141,25 @@ export const SETTINGS_SCHEMA = {
 	// Top-level settings
 	// ─────────────────────────────────────────────────────────────────────────
 	lastChangelogVersion: { type: "string", default: undefined },
-	theme: {
+	"theme.dark": {
 		type: "string",
-		default: undefined,
-		ui: { tab: "display", label: "Theme", description: "Color theme for the interface", submenu: true },
+		default: "titanium",
+		ui: {
+			tab: "display",
+			label: "Dark theme",
+			description: "Theme used when terminal has dark background",
+			submenu: true,
+		},
+	},
+	"theme.light": {
+		type: "string",
+		default: "light",
+		ui: {
+			tab: "display",
+			label: "Light theme",
+			description: "Theme used when terminal has light background",
+			submenu: true,
+		},
 	},
 	symbolPreset: {
 		type: "enum",
@@ -756,6 +771,36 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	// ─────────────────────────────────────────────────────────────────────────
+	// STT settings
+	// ─────────────────────────────────────────────────────────────────────────
+	"stt.enabled": {
+		type: "boolean",
+		default: false,
+		ui: { tab: "input", label: "Speech-to-text", description: "Enable speech-to-text input via microphone" },
+	},
+	"stt.language": {
+		type: "string",
+		default: "en",
+		ui: {
+			tab: "input",
+			label: "STT language",
+			description: "Language code for transcription (e.g., en, es, fr)",
+			submenu: true,
+		},
+	},
+	"stt.modelName": {
+		type: "enum",
+		values: ["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en", "large"] as const,
+		default: "base.en",
+		ui: {
+			tab: "input",
+			label: "STT model",
+			description: "Whisper model size (larger = more accurate but slower)",
+			submenu: true,
+		},
+	},
+
 	// ─────────────────────────────────────────────────────────────────────────
 	// Edit settings
 	// ─────────────────────────────────────────────────────────────────────────
@@ -1061,6 +1106,14 @@ export interface ThinkingBudgetsSettings {
 	high: number;
 }
 
+export interface SttSettings {
+	enabled: boolean;
+	language: string | undefined;
+	modelName: string;
+	whisperPath: string | undefined;
+	modelPath: string | undefined;
+}
+
 export interface BashInterceptorRule {
 	pattern: string;
 	flags?: string;
@@ -1081,6 +1134,7 @@ export interface GroupTypeMap {
 	exa: ExaSettings;
 	statusLine: StatusLineSettings;
 	thinkingBudgets: ThinkingBudgetsSettings;
+	stt: SttSettings;
 	modelRoles: Record<string, string>;
 }
 

package/src/config/settings.ts

@@ -5,7 +5,7 @@
  *   import { settings } from "./settings";
  *
  *   const enabled = settings.get("compaction.enabled");  // sync read
- *   settings.set("theme", "dark");                       // sync write, saves in background
+ *   settings.set("theme.dark", "titanium");               // sync write, saves in background
  *
  * For tests:
  *   const isolated = Settings.isolated({ "compaction.enabled": false });
@@ -19,7 +19,7 @@ import { YAML } from "bun";
 import { type Settings as SettingsCapabilityItem, settingsCapability } from "../capability/settings";
 import type { ModelRole } from "../config/model-registry";
 import { loadCapability } from "../discovery";
-import { setColorBlindMode, setSymbolPreset, setTheme } from "../modes/theme/theme";
+import { isLightTheme, setAutoThemeMapping, setColorBlindMode, setSymbolPreset } from "../modes/theme/theme";
 import { type EditMode, normalizeEditMode } from "../patch";
 import { AgentStorage } from "../session/agent-storage";
 import { withFileLock } from "./file-lock";
@@ -81,7 +81,7 @@ export interface SettingsOptions {
 /**
  * Parse a dotted path into segments.
  * "compaction.enabled" → ["compaction", "enabled"]
- * "theme" → ["theme"]
+ * "theme.dark" → ["theme", "dark"]
  */
 function parsePath(path: string): string[] {
 	return path.split(".");
@@ -531,6 +531,19 @@ export class Settings {
 			}
 		}
 
+		// Migrate old flat "theme" string to nested theme.dark/theme.light
+		if (typeof raw.theme === "string") {
+			const oldTheme = raw.theme;
+			if (oldTheme === "light" || oldTheme === "dark") {
+				// Built-in defaults — just remove, let new defaults apply
+				delete raw.theme;
+			} else {
+				// Custom theme — detect luminance to place in correct slot
+				const slot = isLightTheme(oldTheme) ? "light" : "dark";
+				raw.theme = { [slot]: oldTheme };
+			}
+		}
+
 		return raw;
 	}
 
@@ -628,13 +641,14 @@ export class Settings {
 type SettingHook<P extends SettingPath> = (value: SettingValue<P>, prev: SettingValue<P>) => void;
 
 const SETTING_HOOKS: Partial<Record<SettingPath, SettingHook<any>>> = {
-	theme: value => {
-		// Theme loading is async, but we call it synchronously here.
-		// The hook fires immediately, and the theme system handles async loading internally.
+	"theme.dark": value => {
 		if (typeof value === "string") {
-			setTheme(value, false).catch(err => {
-				logger.warn("Settings: theme hook failed", { theme: value, error: String(err) });
-			});
+			setAutoThemeMapping("dark", value);
+		}
+	},
+	"theme.light": value => {
+		if (typeof value === "string") {
+			setAutoThemeMapping("light", value);
 		}
 	},
 	symbolPreset: value => {

package/src/debug/index.ts

@@ -4,6 +4,7 @@
  * Provides tools for debugging, bug report generation, and system diagnostics.
  */
 import * as fs from "node:fs/promises";
+import * as url from "node:url";
 import { getWorkProfile } from "@oh-my-pi/pi-natives";
 import { Container, Loader, type SelectItem, SelectList, Spacer, Text } from "@oh-my-pi/pi-tui";
 import { getSessionsDir } from "@oh-my-pi/pi-utils/dirs";
@@ -11,8 +12,9 @@ import { DynamicBorder } from "../modes/components/dynamic-border";
 import { getSelectListTheme, getSymbolTheme, theme } from "../modes/theme/theme";
 import type { InteractiveModeContext } from "../modes/types";
 import { openPath } from "../utils/open";
+import { DebugLogViewerComponent } from "./log-viewer";
 import { generateHeapSnapshotData, type ProfilerSession, startCpuProfile } from "./profiler";
-import { clearArtifactCache, createReportBundle, getArtifactCacheStats, getRecentLogs } from "./report-bundle";
+import { clearArtifactCache, createDebugLogSource, createReportBundle, getArtifactCacheStats } from "./report-bundle";
 import { collectSystemInfo, formatSystemInfo } from "./system-info";
 
 /** Debug menu options */
@@ -27,6 +29,11 @@ const DEBUG_MENU_ITEMS: SelectItem[] = [
 	{ value: "clear-cache", label: "Clear: artifact cache", description: "Remove old session artifacts" },
 ];
 
+const formatFileHyperlink = (path: string): string => {
+	const fileUrl = url.pathToFileURL(path).href;
+	return `\x1b]8;;${fileUrl}\x07${path}\x1b]8;;\x07`;
+};
+
 /**
  * Debug selector component.
  */
@@ -159,7 +166,7 @@ export class DebugSelectorComponent extends Container {
 			this.ctx.chatContainer.addChild(
 				new Text(theme.fg("success", `${theme.status.success} Performance report saved`), 1, 0),
 			);
-			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", result.path), 1, 0));
+			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", formatFileHyperlink(result.path)), 1, 0));
 			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", `Files: ${result.files.length}`), 1, 0));
 		} catch (err) {
 			loader.stop();
@@ -220,7 +227,7 @@ export class DebugSelectorComponent extends Container {
 			this.ctx.chatContainer.addChild(
 				new Text(theme.fg("success", `${theme.status.success} Report bundle saved`), 1, 0),
 			);
-			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", result.path), 1, 0));
+			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", formatFileHyperlink(result.path)), 1, 0));
 			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", `Files: ${result.files.length}`), 1, 0));
 		} catch (err) {
 			loader.stop();
@@ -259,7 +266,7 @@ export class DebugSelectorComponent extends Container {
 			this.ctx.chatContainer.addChild(
 				new Text(theme.fg("success", `${theme.status.success} Memory report saved`), 1, 0),
 			);
-			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", result.path), 1, 0));
+			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", formatFileHyperlink(result.path)), 1, 0));
 			this.ctx.chatContainer.addChild(new Text(theme.fg("dim", `Files: ${result.files.length}`), 1, 0));
 		} catch (err) {
 			loader.stop();
@@ -272,26 +279,26 @@ export class DebugSelectorComponent extends Container {
 
 	async #handleViewLogs(): Promise<void> {
 		try {
-			const logs = await getRecentLogs(50);
-			if (!logs) {
+			const logSource = await createDebugLogSource();
+			const logs = await logSource.getInitialText();
+			if (!logs && !logSource.hasOlderLogs()) {
 				this.ctx.showWarning("No log entries found for today.");
 				return;
 			}
 
-			this.ctx.chatContainer.addChild(new Spacer(1));
-			this.ctx.chatContainer.addChild(new DynamicBorder());
-			this.ctx.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", "Recent Logs")), 1, 0));
-			this.ctx.chatContainer.addChild(new Spacer(1));
-
-			// Display logs with dim styling
-			const lines = logs.split("\n").slice(-50);
-			for (const line of lines) {
-				if (line.trim()) {
-					this.ctx.chatContainer.addChild(new Text(theme.fg("dim", line), 1, 0));
-				}
-			}
+			const viewer = new DebugLogViewerComponent({
+				logs,
+				terminalRows: this.ctx.ui.terminal.rows,
+				onExit: () => this.ctx.showDebugSelector(),
+				onStatus: message => this.ctx.showStatus(message, { dim: true }),
+				onError: message => this.ctx.showError(message),
+				onUpdate: () => this.ctx.ui.requestRender(),
+				logSource,
+			});
 
-			this.ctx.chatContainer.addChild(new DynamicBorder());
+			this.ctx.editorContainer.clear();
+			this.ctx.editorContainer.addChild(viewer);
+			this.ctx.ui.setFocus(viewer);
 		} catch (err) {
 			this.ctx.showError(`Failed to read logs: ${err instanceof Error ? err.message : String(err)}`);
 		}

package/src/debug/log-formatting.ts

@@ -0,0 +1,60 @@
+import { sanitizeText } from "@oh-my-pi/pi-natives";
+import { replaceTabs, truncateToWidth } from "../tools/render-utils";
+
+export function formatDebugLogLine(line: string, maxWidth: number): string {
+	const sanitized = sanitizeText(line);
+	const normalized = replaceTabs(sanitized);
+	const width = Math.max(1, maxWidth);
+	return truncateToWidth(normalized, width);
+}
+
+export function formatDebugLogExpandedLines(line: string, maxWidth: number): string[] {
+	const sanitized = sanitizeText(line);
+	const normalized = replaceTabs(sanitized);
+	const width = Math.max(1, maxWidth);
+
+	if (normalized.length === 0) {
+		return [""];
+	}
+
+	return normalized
+		.split("\n")
+		.flatMap(segment => Bun.wrapAnsi(segment, width, { hard: true, trim: false, wordWrap: true }).split("\n"));
+}
+
+export function parseDebugLogTimestampMs(line: string): number | undefined {
+	try {
+		const parsed: unknown = JSON.parse(line);
+		if (!parsed || typeof parsed !== "object") {
+			return undefined;
+		}
+
+		const timestamp = (parsed as { timestamp?: unknown }).timestamp;
+		if (typeof timestamp !== "string") {
+			return undefined;
+		}
+
+		const timestampMs = Date.parse(timestamp);
+		return Number.isFinite(timestampMs) ? timestampMs : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+export function parseDebugLogPid(line: string): number | undefined {
+	try {
+		const parsed: unknown = JSON.parse(line);
+		if (!parsed || typeof parsed !== "object") {
+			return undefined;
+		}
+
+		const pid = (parsed as { pid?: unknown }).pid;
+		if (typeof pid !== "number") {
+			return undefined;
+		}
+
+		return Number.isFinite(pid) ? pid : undefined;
+	} catch {
+		return undefined;
+	}
+}