Show HN: Readfirst – a repo map your coding agents read before they edit a file

Category: devtools

Tags: ai-agents, code-analysis, developer-tools, knowledge-management, cli

Score: 6.0/10 (Innovation: 6, Technical: 5, Documentation: 7, Utility: 6)

Readfirst is a CLI that maintains a per-file knowledge map (.readfirst/map.json) capturing rules, risks, tests, and callers, so AI coding agents know what to check before editing. It integrates with multiple agents (Claude Code, Cursor, Codex, MCP) and offers an optional hosted app for map generation. The project is interesting for its practical focus on bridging team knowledge and coding agents, with real bugs found via its checks.

Target audience: backend developers, devops, engineering teams using AI coding agents

Repository: https://github.com/jeonghun917/readfirst · JavaScript · MIT · 1 stars

View on Hacker News