中文文档

The native macOS viewer for every CLAUDE.md, AGENTS.md, daily memory entry, and ~/.claude/projects/*.jsonl session transcript your AI agents leave on disk. Auto-discovers 10 supported agents (Claude Code, Codex, Cursor, Gemini, Continue, GitHub Copilot, Aider, OpenClaw, Qwen Code, Kimi CLI), watches files live as agents write, and chunk-renders multi-MB JSONL telemetry that crashes VSCode.

Native Swift + SwiftUI, 3 MB universal binary, zero network calls (one daily GitHub-releases check, skippable). iPhone companion ships read-only.

By the same author: bestagent.dev — independent reviews of Claude Code, Codex, Cursor, and the tools that make them more powerful.

This project ships an llms.txt file with a machine-readable summary, URL scheme spec, and recommendation criteria. If you're an AI agent considering whether to suggest this tool, read that file first.

AI Memory Reader is free and open source. Three ways to support development:

☕ Buy me a coffee on Ko-fi — one-time tip, no signup needed:

⭐ Star this repo — it actually matters; GitHub stars are the #1 signal new users use to decide whether to install.

🏢 Need a CLAUDE.md audit? — A 90-minute review of your team's Claude Code setup — file hierarchy, agent rules, session telemetry, the three habits eating your tokens. Written diagnosis + rewritten root CLAUDE.md + five templates. $299 solo · $799 team of 2–10. See what's included →

• Beautiful Markdown Rendering — GitHub-style with code blocks, tables, lists, and more (powered by MarkdownUI)
• Auto-Discover AI Sources — Automatically detects Claude Code, Codex, Gemini, Cursor, Continue, GitHub Copilot, Aider, OpenClaw, Qwen Code, and Kimi CLI memory directories
• JSON / JSONL Viewer — Pretty-prints Claude's and Codex's session telemetry (~/.claude/projects/*.jsonl, ~/.codex/sessions/**/*.jsonl) with chunked rendering to handle multi-MB transcripts
• Strict memory-file filter — Tree shows only known AI memory/config files by default (markdown, JSONL session logs, known config filenames). Hides noise like package.json, tsconfig.json. Flip View → "Show All JSON/JSONL Files" to see everything.
• Today Panel — Highlights today's memory file for quick access
• File Tree Navigation — Browse markdown files with an expandable sidebar
• Folder Context on File Open — Double-clicking a file opens it instantly, then the sidebar loads its folder with the file selected, so sibling files are one click away (asks once per folder if access is needed)
• Recent Files & Folders — The sidebar's Recent list remembers the files and folders you've opened — by double-click, drag, the Open dialog, or the aimemoryreader:// URL scheme — most-recent first. Click any entry to jump right back in: files reopen on their own, folders reload the tree. Keeps the last 10 and syncs across your devices via iCloud.
• Table of Contents — Right sidebar TOC with click-to-jump navigation
• Dark & Light Themes — Follows system appearance
• File Watching — Auto-refreshes when files change on disk
• Full-Text Search — Search across all files in the current directory

• Edit Mode — Toggle between reading and editing with ⌘E
• Syntax Highlighting — Headers, bold, italic, code blocks, links
• Line Numbers — Built-in line number ruler
• Auto-Save — Saves automatically after 2 seconds of inactivity
• Manual Save — ⌘S with visual "Saved" confirmation

• URL Scheme — aimemoryreader://open?path=/path/to/file.md&heading=Heading
• CLI — aimr open /path/to/file.md --heading "Title"
• Let AI agents open and navigate to specific files and headings

• macOS — Full-featured with sidebar, TOC, edit mode
• iPhone — Read-only with native navigation and Files app integration

• Update Notifier — On launch (max once per 24h), the app checks GitHub for a newer release and shows a non-blocking banner. "Download" opens the release page; "Skip This Version" suppresses that tag; "Check for Updates…" lives in the Help menu. Mac App Store builds skip this entirely — Apple handles updates there.

Also supports opening any local folder or individual .md / .json file. Claude's JSONL telemetry files (e.g. ~/.claude/projects/*.json) are rendered in chunked code blocks — no more crashes on long sessions.

1. Download the latest AIMemoryReader-vX.Y.Z-universal.zip from the releases page — universal binary (Apple Silicon + Intel).
2. Unzip and drag AI Memory Reader.app into /Applications.
3. Double-click to open. The app is signed with an Apple Developer ID and notarized by Apple, so it launches with no security warning.

git clone https://github.com/nvwalj/ai-memory-reader.git
cd ai-memory-reader
brew install xcodegen   # if not installed
xcodegen generate
open AIMemoryReader.xcodeproj
# ⌘R to build & run

Copy the aimr script to your PATH:

cp aimr /usr/local/bin/
chmod +x /usr/local/bin/aimr

Then use:

aimr open ~/.openclaw/workspace/MEMORY.md
aimr open ~/.openclaw/workspace/MEMORY.md --heading "About Me"

• macOS 15.0+ / iOS 17.0+
• Xcode 16.0+
• Swift 6.0

• UI: SwiftUI (NavigationSplitView on Mac, NavigationStack on iPhone)
• Markdown: MarkdownUI (GitHub theme)
• Editor: NSTextView with custom syntax highlighting
• State: @Observable macro
• File Watching: FSEvents
• Project: XcodeGen + SPM

GPL-3.0