Documentation

Complete guide to Remember This for Mac - your AI-powered external memory system designed for ADHD minds.

Core Philosophy

Remember This works on a simple principle: capture everything, process nothing in the moment.

Reduce cognitive load

Don't try to remember—just capture

Find patterns

AI processes your captures to surface what matters

Build momentum

Daily summaries help you see progress (which ADHD brains desperately need)

The key is to make capturing so effortless that you do it without thinking. Processing happens in the background while you live your life.

How It Works: Architecture

Remember This operates in three layers:

Layer 1: Mac App (Pre-Processing)

Automated background processing

Three Life Assets:

  • • Voice Memos - Auto-transcribed with Whisper (Metal GPU, 99+ languages)
  • • Photos & Videos - Auto-captioned with Ollama vision models
  • • Time Tracking - Parsed from neamtime format (via Obsidian plugin)

Watchers & Processors:

  • • Voice Watcher monitors voice memos directory
  • • Photo Watcher checks Photos library every minute
  • • MD-QUEUE pattern for crash recovery and parallel processing

All life assets are saved to life-assets/ in your vault (voice/, photos/, parsed-time-logs/).

Layer 2: Automatic Rollups

Time-based aggregation

Automatically-generated rollups that aggregate your life assets by time period:

  • • Daily rollups - Created at 4 AM, lists all captures from previous day
  • • Weekly rollups - Aggregates daily rollups
  • • Monthly rollups - Aggregates weekly rollups
  • • Yearly rollups - Aggregates monthly rollups

Rollups are saved to life/ folder and include embedded photos, links to transcripts, and stats.

Layer 3: Claude Code (Intelligence Layer)

Scheduled AI processing

Claude Code runs on your schedule (e.g., once daily at 11 PM) and:

  • • Reviews recent rollups and captures per your CLAUDE.md instructions
  • • Generates insights and identifies patterns
  • • Updates your orientation board
  • • Extracts tasks and creates diary entries

Schedule: Configurable daily processing (default: once per day) or trigger manually via "Process Now" button

Installation

System Requirements

Required:

  • macOS 15.0 or later (Apple Silicon recommended for best performance)
  • Claude Code CLI - Download from code.claude.com (requires Anthropic subscription)

Recommended:

  • Obsidian - For enhanced vault UI (obsidian.md)
  • Obsidian Sync (~€10/month) or use iCloud/Dropbox for cross-device syncing

All AI preprocessing happens locally on your device

Whisper and vision models download automatically during setup. Claude Code uses cloud models by default.

Download & Install

Follow these steps to install Remember This

1

Download Remember This for Mac

Download DMG
2

Open the downloaded DMG file and drag Remember This to your Applications folder

3

Launch the app and grant permissions when prompted (Photos Library Access, Full Disk Access)

4

The onboarding wizard will guide you through the rest of the setup

Getting Started

Complete App Onboarding

The app handles most setup automatically

When you first launch Remember This, the onboarding wizard will:

  • • Ask where to create your vault (local or cloud storage)
  • • Let you choose a CLAUDE.md template (Basic, ADHD, Freelancer, Creative, Parent)
  • • Configure Claude Code scheduling (daily processing time)
  • • Test your complete setup

The app handles all of this for you! No manual configuration needed.

Open Your Vault in Obsidian (Optional)

While not required, Obsidian provides the best experience:

  1. Open Obsidian
  2. Click "Open folder as vault" and select your Remember This Vault location
  3. Install the Remember This Obsidian plugin if prompted
  4. Access the Orientation Board from the left sidebar

Voice Memos: Your Stream of Consciousness

Voice memos are your most powerful tool. They're fast, require no setup, and capture thoughts before they evaporate.

What to Record

Task Captures

"I need to email Sarah about the project deadline"

Insights & Ideas

"Just realized why the client was upset—they needed the data sorted differently"

Emotional Check-ins

"Feeling really overwhelmed right now, everything feels urgent"

Context Captures

"At the coffee shop on 5th street where I had that breakthrough"

Decision Logs

"Decided to go with vendor A because they had better customer service reviews"

How to Record Effectively

• Keep it short - 30 seconds to 2 minutes is ideal

• Don't self-edit - just talk naturally

• Capture immediately - the 5-second rule (if you wait, the thought is gone)

• Use natural language - talk like you're texting a friend

Photos & Videos: Visual Memory Anchors

ADHD brains are often highly visual. Photos and videos aren't just memories—they're anchors that help you reconstruct entire experiences.

What to Capture

Environmental Context

Where you are when you have that voice memo idea, whiteboard sessions, workspace

Visual Documentation

Screenshots, handwritten notes, receipts, before/after states

People & Moments

Social events, new acquaintances (faces + names = better recall)

Progress Tracking

Daily photos of long-term projects, workspace evolution

Pro tip: Take a quick voice memo after photos to add context that AI can't infer (who you're with, why this matters, background story)

Journals & Time Tracking

Manual Journaling

Your structured reflection space

Daily Reflections (5-10 minutes)

What happened, how you felt, what you learned, what you're grateful for

Weekly Reviews (15-30 minutes)

Wins, challenges, patterns noticed, next week's focus

Project Logs

Status, decisions made, blockers, next actions

Time Tracking

Combat time blindness, track billable hours

Write time logs in simple markdown, then the Obsidian plugin parses them into structured data for:

  • • Client invoicing (automated invoice data generation)
  • • Productivity analysis (when do you work on what?)
  • • Pattern recognition (combat time blindness)

Obsidian Plugin: Your Command Center

Orientation Board

Your temporal lens on life

A bi-directional view showing your life on a logarithmic time scale - both past and future - in a single glance.

Time buckets:

5 minutes · 15 minutes · 1 hour · 6 hours · 1 day · 3 days · 1 week · 1 month · 3 months · 6 months · 1 year · 3 years · 10 years

Each bucket shows tasks, ideas, key moments (past), and plans/intentions (future) at that timescale.

Daily/Weekly/Monthly Rollups

Automatically generated summaries showing activity patterns, emotional trends, accomplishments, and AI-spotted insights.

Photo Context View

Click any photo to see voice memos from around that time, journal entries from that day, and related photos from the same location.

Why This Matters for ADHD

Remember This is specifically designed to address ADHD challenges:

Working Memory Support

Voice memos capture thoughts before they evaporate. Your brain can focus on thinking, not on trying to remember what you were supposed to be thinking about.

Time Blindness Reduction

Timestamped captures create a concrete timeline of your day. Daily/weekly/monthly rollups give you longer-term time perspective.

Executive Function Support

Orientation board forces you to choose priorities. Weekly reviews build planning muscle. Task captures get things out of your head for strategic processing.

Progress Visibility

Daily rollups show concrete evidence of what you accomplished. Photo sequences provide visual proof of progress. Combat "I got nothing done" feelings with data.

Cognitive Load Reduction

Capture is effortless. No filing or organizing required. AI processes everything automatically. You spend brain power on living your life, not maintaining your system.

Daily Workflow Examples

The Balanced Day

7:00 AM - Morning brain dump voice memo, check orientation board (5 mins)

9:00 AM - Start work, take photo of clean workspace

11:00 AM - Break walk with voice memo about new idea

1:00 PM - Quick journal entry about morning productivity

5:30 PM - End-of-work voice memo summary, photo of completed work

8:00 PM - Review today's rollup, evening gratitude journal

Total capture time: ~20 minutes spread throughout the day

The Chaotic Day

Running late - Quick voice memo while getting ready

Client emergency - Voice memos as thoughts come up, photos of error messages

Scattered focus - Just capture whatever happens, no structure needed

Evening - 5-minute brain dump, review rollup to see you actually DID get things done

Result: Even on chaotic days, you've captured what happened. The AI processes it into a coherent story.

Pro Tips

1. The 5-Second Capture Rule

If a thought seems worth remembering, you have 5 seconds to capture it before ADHD makes it disappear. Quick is better than perfect, always.

2. Batch Reviewing, Not Capturing

Capture throughout the day (seconds each time). Review in batches: morning (2 mins), evening (3 mins), weekly (15 mins).

3. Link Captures for Context

When you take a photo, immediately do a voice memo explaining what you're looking at. The app will link them together.

4. The "Sunday Reset" Ritual

Every Sunday evening: review last week's rollup, write weekly reflection, update orientation board, set weekly theme. Creates structure without being overwhelming.

5. The "Done List" Habit

End each day with a voice memo or journal of "What I completed today." Even tiny things count. Combats "I never finish anything" narrative.

Troubleshooting

Voice memos not appearing

Cause: Full Disk Access not granted

Solution: System Settings → Privacy & Security → Full Disk Access → Enable for Remember This

Photos not appearing

Cause: Photos Library Access not granted

Solution: System Settings → Privacy & Security → Photos → Enable for Remember This

Claude Code commands not found

Cause: Plugin not installed correctly

Solution: Run claude --debug to verify plugin loading, reinstall if needed

Claude Code scheduler not running

Cause: Claude CLI not installed or not authenticated

Solution: Verify claude --version works, run claude auth login if needed, and check Settings to enable automatic daily processing

Transcription very slow

Cause: Running in debug mode (CPU-only)

Solution: Ensure Remember This is built in release mode for Metal GPU acceleration

Need Help?

If you're having trouble getting started or have questions about Remember This, we're here to help.