CODE-1902 change TUI log storage — Claude Code subagent
CODE-1902 change TUI log storage is a Claude Code subagent that moves TUI logs into a frontend-specific directory while keeping GUI channel filenames. It also fixes /view-logs collection.
AGPL-3.0 ★ 720 updated 2026-11-10
.claude/agents/CODE-1902-change-TUI-log-storage.mdWhat CODE-1902 change TUI log storage does
CODE-1902 change TUI log storage updates how headless TUI processes resolve their log files. New TUI sessions use the warp-cli subdirectory and retain the channel names used by the GUI, including warp_local.log, warp_dev.log, warp_preview.log, and warp.log. Rotation follows the same resolved filename.
The change covers recovery paths, archive creation, prompt-chip sidecars, and /view-logs. GUI launches keep their current directory and behavior, while CLI, remote proxy, and remote daemon launches continue using oz. Existing files in ~/Library/Logs/oz/ stay untouched; on macOS, new TUI logs go under ~/Library/Logs/warp-cli/.
What it helps with
- separate TUI log files from GUI logs
- keep channel filenames aligned across Local, Dev, Preview, and Stable
- bundle active and rotated TUI logs through
/view-logs - preserve existing GUI, CLI, and legacy
ozpaths - resolve prompt-chip sidecars from the logger's active path
Example prompts for the agent
- Update CODE-1902 so TUI logs use a
warp-clisubdirectory without changing GUI paths. - Make
/view-logscollect the active TUI log and its rotated companions from the resolved TUI location. - Verify that Local, Dev, Preview, and Stable keep the filenames
warp_local.log,warp_dev.log,warp_preview.log, andwarp.log.
How to install CODE-1902 change TUI log storage
Manually: put the files in place
.claude/agents/CODE-1902-change-TUI-log-storage.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/CODE-1902-change-TUI-log-storage.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/CODE-1902-change-TUI-log-storage.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about CODE-1902 change TUI log storage
How do I install CODE-1902 change TUI log storage in Claude Code?
Add the subagent file from the repository at .claude/agents/CODE-1902-change-TUI-log-storage.md.
What does CODE-1902 change TUI log storage do?
It moves TUI logs into warp-cli, keeps the GUI channel filenames, and makes /view-logs use the resolved TUI location. GUI and CLI behavior stays separate.
What happens to existing logs in ~/Library/Logs/oz/?
Existing files remain where they are and are not deleted. New TUI sessions use ~/Library/Logs/warp-cli/ on macOS.