{"slug": "stop-rescanning-every-claude-code-transcript", "title": "Stop Rescanning Every Claude Code Transcript", "summary": "Agent Island, an open-source status companion for Claude Code and Codex, introduces an append-aware cursor to efficiently monitor transcript archives without rescanning every file. The cursor uses a lightweight discovery pass to track file identity, size, and modification time, parsing only new or changed files and resuming from the last complete byte offset. This approach ensures steady-state cost scales with changed data rather than total archive size, avoiding correctness risks like mid-line parsing or stale evidence.", "body_md": "A transcript monitor can poll frequently without becoming expensive. The problem is not the timer by itself; it is treating the entire archive as the hot path on every tick.\n\nWhen a developer has months of Claude Code history, reopening every transcript and parsing a tail from every file makes steady-state work proportional to archive size. It also creates correctness risks: a tail can begin in the middle of a JSON line, older completion evidence can outrank a newer handoff, and multiple sessions can be collapsed into one global answer.\n\nUse a lightweight discovery pass to retain file identity, size, and modification time. Only a new or changed file should enter the parsing queue. A known transcript should resume from its last complete byte offset rather than being reread from the beginning.\n\nAn append-aware cursor needs five behaviors:\n\nThe cursor is an optimization only if recovery is correct. A smaller file, changed identity, or invalid continuation should trigger a bounded rebuild instead of silently dropping records.\n\nReading fewer bytes does not justify guessing. Keep provider and session identity, compare ordered timestamps, and distinguish working, waiting, your-turn, error, finished, and stale evidence. Silence describes freshness; it does not prove successful completion.\n\nMeasure files inspected, bytes read, parse failures, queue depth, and scan duration. Test with a large archive. Healthy steady-state cost should scale with changed files and appended bytes, not total history.\n\nAgent Island is a free, open-source status companion for Claude Code and Codex on macOS and Windows. It reads local session records to show status and your-turn alerts, uses no Agent Island account, and does not upload session data to Agent Island. I help run Agent Island; the detailed engineering guide is here:", "url": "https://wpnews.pro/news/stop-rescanning-every-claude-code-transcript", "canonical_source": "https://dev.to/agentis/stop-rescanning-every-claude-code-transcript-1j6j", "published_at": "2026-07-29 01:12:31+00:00", "updated_at": "2026-07-29 02:00:08.356899+00:00", "lang": "en", "topics": ["developer-tools", "ai-tools"], "entities": ["Agent Island", "Claude Code", "Codex", "macOS", "Windows"], "alternates": {"html": "https://wpnews.pro/news/stop-rescanning-every-claude-code-transcript", "markdown": "https://wpnews.pro/news/stop-rescanning-every-claude-code-transcript.md", "text": "https://wpnews.pro/news/stop-rescanning-every-claude-code-transcript.txt", "jsonld": "https://wpnews.pro/news/stop-rescanning-every-claude-code-transcript.jsonld"}}