# CODE-1902 change TUI log storage

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/code-1902-change-tui-log-storage

## What it 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/`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/CODE-1902-change-TUI-log-storage.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/CODE-1902-change-TUI-log-storage.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/CODE-1902-change-TUI-log-storage.md` — Cursor also reads .claude/agents/

## When to use it
- 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 `oz` paths
- resolve prompt-chip sidecars from the logger's active path

## Example prompts
- Update CODE-1902 so TUI logs use a `warp-cli` subdirectory without changing GUI paths.
- Make `/view-logs` collect 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`, and `warp.log`.

## Similar
- [tui-validate](https://affpapa.org/en/nevibecode/skills/tui-validate.md) — skill · ★ 3206 repo stars
- [codex-tui-proof](https://affpapa.org/en/nevibecode/plugins/codex-tui-proof.md) — plugin · ★ 1596 repo stars
- [tui-debug-in-pane](https://affpapa.org/en/nevibecode/skills/tui-debug-in-pane.md) — skill · ★ 3206 repo stars
- [textual-tui-skill](https://affpapa.org/en/nevibecode/skills/textual-tui-skill.md) — skill · 268 installs
- [tui-design](https://affpapa.org/en/nevibecode/skills/tui-design.md) — skill · 1400 installs
- [ratatui-tui](https://affpapa.org/en/nevibecode/skills/ratatui-tui.md) — skill · 959 installs

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
