explaingit

nvwalj/ai-memory-reader

25Swift

TLDR

AI Memory Reader is a native Mac and iPhone app for browsing the memory and instruction files that AI coding assistants drop on disk.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

In plain English

AI Memory Reader is a native Mac and iPhone app for browsing the memory and instruction files that AI coding assistants drop on disk. When you use a tool like Claude Code, Codex, Cursor, or Gemini, each one leaves behind files such as CLAUDE.md, AGENTS.md, daily memory entries, and long JSON session transcripts. This app finds those files automatically and shows them in one viewer instead of scattering you across folders. It is written in Swift and SwiftUI, ships as a 3 MB universal binary, and makes no network calls aside from an optional daily check for new releases. It auto detects eight tools: Claude Code, Codex, Gemini, Cursor, Continue, GitHub Copilot, Aider, and OpenClaw, each with its own home folder under your user directory. It also opens any local folder or single .md or .json file. One specific pain point it addresses is Claude's session telemetry files at ~/.claude/projects, which can be many megabytes long and crash editors like VS Code. AI Memory Reader pretty prints them in chunks so the viewer stays responsive. The reading side has GitHub style Markdown rendering, a file tree sidebar, a clickable table of contents, dark and light themes that follow the system, full text search across the current folder, a Today panel that highlights the day's memory file, and live file watching so the view refreshes as agents write to disk. The editing side is lighter: a toggle with Cmd-E switches into an editor with basic syntax highlighting and line numbers, autosave after two seconds of idleness, and a manual save shortcut. The app can be driven from outside too. A URL scheme of the form aimemoryreader://open?path=...&heading=... lets other programs or agents jump to a specific file and heading. A small aimr command line tool ships alongside it for the same job. The iPhone build is read only and integrates with the Files app. Installation is a download from GitHub releases, drag into Applications, then bypass the macOS unidentified developer warning since the build is ad-hoc signed rather than notarized. Building from source uses xcodegen, Xcode 16, and Swift 6 on macOS 15 or iOS 17 and newer. The project is GPL-3.0 licensed.

Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.