AI Memory Reader – Native macOS app for browsing Claude Code memory files

Notifications You must be signed in to change notification settings

Fork 0

Star 1

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

41 Commits

41 Commits

.github

.github

AIMemoryReader.xcodeproj

AIMemoryReader.xcodeproj

AIMemoryReader

AIMemoryReader

docs

docs

.gitignore

.gitignore

AIMemoryReader-iOS.entitlements

AIMemoryReader-iOS.entitlements

LICENSE

LICENSE

PLAN.md

PLAN.md

README.md

README.md

README_CN.md

README_CN.md

V2-PLAN.md

V2-PLAN.md

V3-PLAN.md

V3-PLAN.md

aimr

aimr

home.png

home.png

icon.png

icon.png

project.yml

project.yml

Repository files navigation

中文文档

A native macOS & iOS app for browsing, reading, and editing AI agent memory files — beautifully rendered, instantly accessible.

The only native macOS & iOS app for browsing your AI agent's memory. Built for Claude Code, OpenClaw, Codex, Cursor, Gemini, and more.

❤️ Support This Project

AI Memory Reader is free and open source. If it saves you time or you'd like to see it evolve, please consider supporting development on Ko-fi ↗ — every coffee fuels new features.

Features

Reading

Beautiful Markdown Rendering — GitHub-style with code blocks, tables, lists, and more (powered by MarkdownUI)

Auto-Discover AI Sources — Automatically detects OpenClaw memory directories

Today Panel — Highlights today's memory file for quick access

File Tree Navigation — Browse markdown files with an expandable sidebar

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

Editing

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

AI Tool Integration

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

Cross-Platform

macOS — Full-featured with sidebar, TOC, edit mode

iPhone — Read-only with native navigation and Files app integration

Supported AI Sources

AI Source Directory Key Files

OpenClaw ~/.openclaw/workspace/ MEMORY.md, SOUL.md, AGENTS.md, memory/*.md

Also supports opening any local folder or individual .md file.

Installation

Option 1 — Download (fastest, no Xcode needed)

Download the latest AI-Memory-Reader-0.4.0-universal.zip — universal binary, runs on both Apple Silicon and Intel Macs.

Unzip and drag AI Memory Reader.app into /Applications.

First launch: macOS will say "unidentified developer" because the binary is ad-hoc signed (not yet notarized). Two ways to bypass:

GUI: right-click the app in Finder → Open → click Open in the dialog. Once approved, double-click works forever.

Terminal one-liner:

xattr -dr com.apple.quarantine "/Applications/AI Memory Reader.app"

A notarized build will ship once a Developer ID is set up.

Option 2 — Build from source

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

CLI Setup (optional)

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"

Requirements

macOS 15.0+ / iOS 17.0+

Xcode 16.0+

Swift 6.0

Tech Stack

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

Keyboard Shortcuts

Shortcut Action

⌘O Open file or folder

⌘E Toggle edit/read mode

⌘S Save (in edit mode)

⌘F Focus search

⌘1 Switch to OpenClaw source

⌘2 Open local files

License

GPL-3.0

About

The native macOS & iOS app for browsing AI agent memory files — Claude Code, OpenClaw, Codex, Cursor, Gemini

nvwalj.github.io/ai-memory-reader/

Topics

macos

swift

markdown

ios

memory

gemini

cursor

markdown-viewer

codex

native-app

ai-agents

claude

swiftui

ai-tools

claude-code

Resources

Readme

License

View license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks

Report repository

Releases 1

AI Memory Reader v0.4.0

Latest

May 16, 2026

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

Swift 98.6%

Shell 1.4%