ai-memory-reader
Adds /aimr slash command that opens CLAUDE.md and other AI agent memory files in AI Memory Reader — a free open-source native macOS & iOS ap
Open source Repository Open in the app JSON README (API)
About
Adds /aimr slash command that opens CLAUDE.md and other AI agent memory files in AI Memory Reader — a free open-source native macOS & iOS app with markdown rendering, file tree, in-page find, and edit mode. Complements the internal claude-md-management plugin (which writes/improves CLAUDE.md) by providing a polished native viewer.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- nvwalj
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-05-17T16:58:57Z
- Repository state
- ativo
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
nvwalj/aimr-claude-plugin/ai-memory-reader
README
# AI Memory Reader Plugin Adds the `/aimr` slash command to Claude Code, which opens `CLAUDE.md` and other AI agent memory files in [AI Memory Reader](https://github.com/nvwalj/ai-memory-reader) — a free, open-source **native macOS & iOS** app with: - Beautiful GitHub-style markdown rendering (MarkdownUI) - Sidebar file tree across all your AI tool memory directories - In-page find (⌘F) with character-level highlighting - Edit mode (⌘E) with syntax highlighting and auto-save - JSON / JSONL viewer for Claude session telemetry files - URL scheme + CLI for agent integration ## How it complements existing plugins | Plugin | Role | |---|---| | `claude-md-management` (Anthropic, internal) | Audit, improve, and capture session learnings into CLAUDE.md | | **`ai-memory-reader`** (this plugin, external) | **Open and read CLAUDE.md beautifully in a native macOS/iOS app** | The two plugins are complementary: `claude-md-management` is the writer, this is the reader. ## Usage ``` /aimr # Open the closest CLAUDE.md (cwd, then git root, then ~/.claude/) /aimr CLAUDE.md # Open a specific file /aimr ./docs/AGENTS.md # Open by relative path /aimr CLAUDE.md#Conventions # Open and jump to a heading /aimr ~/.claude/CLAUDE.md # Open global user memory ``` ## Requirements - macOS 15+ (the AI Memory Reader app is macOS/iOS only) - AI Memory Reader installed at `/Applications/AI Memory Reader.app` or `~/Applications/AI Memory Reader.app` — always use the latest release: <https://github.com/nvwalj/ai-memory-reader/releases/latest> - **v0.4.1+ recommended** if you plan to open Claude's `~/.claude/projects/*.json` session-telemetry files. Earlier versions could hit a SwiftUI stack overflow on large NDJSON files; v0.4.1 chunks the rendering and v0.4.2 hardens path validation in the URL-scheme handler. If the app is not installed, the command will print download instructions and exit gracefully. ## How it works The plugin uses the `aimemoryreader://open?path=...&heading=...` URL scheme, dispatched via `open` on macOS. AI Memory Reader registers this scheme via its Info.plist; if the app is running, the requested file/heading is brought into focus, otherwise the app launches first. ## Auto-detected memory sources in AI Memory Reader When you open the app directly (or via this command), it automatically discovers memory directories from: - **Claude Code** (`~/.claude`, project-level `CLAUDE.md`) - **OpenClaw** (`~/.openclaw/workspace`) - **Codex** (`~/.codex`) - **Cursor** (`~/.cursor`) - **Gemini** (`~/.gemini`) - **Continue** (`~/.continue`) - **Aider** (`~/.aider`) - **GitHub Copilot** (`~/.config/github-copilot`) You can also add any custom folder as a source from the sidebar `+` button. ## Links - App repository: <https://github.com/nvwalj/ai-memory-reader> - Landing page with screenshots: <https://nvwalj.github.io/ai-memory-reader/> - Companion guide on Claude Code memory file locations: <https://nvwalj.github.io/ai-memory-reader/claude-code-memory-guide.html> ## License Plugin: MIT App (AI Memory Reader): GPL-3.0