# APP-4882 - fix misleading oversized-file read error

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.

- 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/app-4882-fix-misleading-oversized-file-read-error

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

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.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

### Codex

**Manually: put the files in place**
- File: `.codex/agents/APP-4882---fix-misleading-oversized-file-read-error.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/APP-4882---fix-misleading-oversized-file-read-error.md` — Cursor also reads .claude/agents/

## When to use it
- 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
- 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.

## Similar
- [read-file](https://affpapa.org/en/nevibecode/skills/read-file.md) — skill · 1400 installs
- [fix-codesign-error](https://affpapa.org/en/nevibecode/commands/fix-codesign-error.md) — command · ★ 8052 repo stars
- [web-app-optimization-cursorrules-prompt-file](https://affpapa.org/en/nevibecode/rules/web-app-optimization-cursorrules-prompt-file.md) — rule · ★ 41178 repo stars
- [nextjs-app-router-cursorrules-prompt-file](https://affpapa.org/en/nevibecode/rules/nextjs-app-router-cursorrules-prompt-file.md) — rule · ★ 41178 repo stars
- [Audio File MCP App](https://affpapa.org/en/nevibecode/mcp/audio-file-mcp-app.md) — MCP server · ★ 44 repo stars
- [oversized-skill](https://affpapa.org/en/nevibecode/skills/oversized-skill.md) — skill · ★ 1472 repo stars

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
