Skip to main content
subagent CX Codex

APP-4882 - fix misleading oversized-file read error — subagent

APP-4882 - fix misleading oversized-file read error is a Claude Code subagent that gives large-file read failures the right reason. It applies to read_files, get_files, and search_codebase.

AGPL-3.0 ★ 720 updated 2026-11-10

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/APP-4882---fix-misleading-oversized-file-read-error.md
Open on GitHub

What APP-4882 - fix misleading oversized-file read error does

This subagent separates local file-read failures by cause. Missing paths, files above the 1 MB limit, and image-processing failures receive different messages, while an oversized file report includes both its size and the allowed limit.

The change uses describe_failed_files across read_files, get_files, and search_codebase, so mixed batches keep one path-specific reason per failure. Partial success remains intact, and the remote proto path receives the same message. Successful reads, truncation, and byte budgeting stay unchanged.

What it helps with

  • report why an existing file above 1 MB could not be read
  • separate missing paths from image-processing failures
  • show every failure reason in a mixed file batch
  • keep error text consistent across three file-reading tools

Example prompts for the agent

  • Use the APP-4882 - fix misleading oversized-file read error subagent to fix the misleading error for an oversized file.
  • Update read_files, get_files, and search_codebase so each failed path shows its own reason.
  • Split BinaryFileReadResult failure cases without changing successful reads or the 1 MB limit.

How to install APP-4882 - fix misleading oversized-file read error

Manually: put the files in place

.claude/agents/APP-4882---fix-misleading-oversized-file-read-error.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about APP-4882 - fix misleading oversized-file read error

How do I install APP-4882 - fix misleading oversized-file read error in Claude Code?

Add .claude/agents/APP-4882---fix-misleading-oversized-file-read-error.md to the Claude Code agents directory.

What does APP-4882 - fix misleading oversized-file read error do?

It replaces the generic missing-file result with separate reasons for a missing path, an oversized file, and an image-processing failure. The same reason format is used by the three file-reading tools.

How does APP-4882 handle a file above the size limit?

An existing file above 1 MB is reported with its size and the permitted limit. The reason is stored separately from the path, so the combined message does not repeat the filename.

Similar subagents

Subagents catalog →

From the same set62

The whole set →
APP-4913-tui-input-prompt-prefix APP-4913-tui-input-prompt-prefix is a Claude Code subagent that adds a prompt gutter to the harp TUI input line. It renders distinct indicator glyphs for agent prompts and shell commands. CX Codex ★ 720repo stars APP-4903 improve TUI tab bar keybindings APP-4903 improve TUI tab bar keybindings is a Claude Code subagent for orchestration TUI focus. It changes Down and Escape behavior and checks the related regressions. CX Codex ★ 720repo stars CODE-1890-status-line-v2 CODE-1890-status-line-v2 is a Claude Code subagent that refactors the TUI footer in crates/warp_tui. Converts the split metadata view into a unified left-aligned status line. CX Codex ★ 720repo stars CODE-1908 TUI default profile uses AgentDecides CODE-1908 TUI default profile uses AgentDecides is a Claude Code subagent that configures execution permissions in Warp's headless TUI. It applies the AgentDecides policy when no profiles are set. CX Codex ★ 720repo stars APP-4901-add-fast-forward-slash-command APP-4901-add-fast-forward-slash-command is a Claude Code subagent that adds /auto-approve to Warp's TUI and toggles approval for one conversation. CX Codex ★ 720repo stars APP-4907 - TUI input focus during agent drafting APP-4907 is a Claude Code subagent that keeps TUI input active while an agent prepares a tool call, then hands focus to an approval card when blocking begins. CX Codex ★ 720repo stars 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. CX Codex ★ 720repo stars APP-4880 - TUI view-logs slash command APP-4880 - TUI view-logs slash command is a Claude Code subagent that adds a /view-logs TUI command to pack logs into a zip. It prints the absolute path and opens the OS file manager. CX Codex ★ 720repo stars

Project sponsors

Companies that keep this analytics open