Metadata-Version: 2.4
Name: claw-memory
Version: 1.0.1
Summary: Record and search your AI chat history. Markdown files, zero dependencies beyond MCP.
Author: OpenClaw Contributors
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: agent,chat-history,markdown,mcp,memory
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Description-Content-Type: text/markdown

# OpenClaw Memory

**Your AI conversations disappear after every session. OpenClaw Memory fixes that.**

Every time you chat with an AI coding assistant, valuable context — decisions, solutions, debugging steps — vanishes when the session ends. The next session starts from zero.

OpenClaw Memory automatically records every conversation turn to local Markdown files, making your entire AI chat history searchable and browsable. No cloud, no database — just plain text files in your project.

## How It Works

```
You chat with AI  →  Every turn auto-saved to .openclaw_memory/journal/2026-02-24.md
                  →  Search past conversations via MCP tool or web viewer
```

Each journal entry captures the complete conversation: timestamps, model used, your input, the AI's full response, and any code changes made.

## Quick Start

**1. Install**

```bash
pip install claw-memory
```

**2. Initialize in your project**

```bash
cd your-project
claw-memory init
```

This creates:
- `.openclaw_memory/journal/` — where chat history lives
- `.cursor/mcp.json` — connects the MCP server to Cursor
- `.cursor/rules/memory.mdc` — tells the AI agent to auto-record

**3. Restart Cursor** — that's it. Every conversation is now being recorded.

## Searching Past Conversations

The AI agent can search your history automatically. Just ask naturally:

> "We discussed this before, what was the solution?"
>
> "Last time we fixed a similar bug, how did we do it?"

The agent will call `memory_search()` behind the scenes and find matching conversations.

### Search via Web Viewer

```bash
claw-memory web
```

Opens a browser-based viewer where you can:
- Browse journal files by date
- Full-text search across all conversations
- Dark/light mode

## What Gets Recorded

Each conversation turn is saved as Markdown:

```markdown
## 14:32 | claude-4-opus

### User

How do I fix the N+1 query problem in the user list endpoint?

### Agent

The issue is in `api/users.py` where each user triggers a separate query for their roles...

### Code Changes

- `api/users.py` (modified)
- `tests/test_users.py` (modified)
```

## MCP Tools

| Tool | Purpose |
|---|---|
| `memory_log_conversation` | Record a complete conversation turn |
| `memory_log_conversation_append` | Append to the last turn (for long responses) |
| `memory_search` | Search chat history by keyword |

## Storage

All data is stored locally in `.openclaw_memory/journal/` as plain Markdown files — one file per day. No database, no cloud sync. You own your data.

The `.openclaw_memory/` directory is auto-gitignored to prevent accidental commits of chat history.

## Project Isolation

Each project gets its own `.openclaw_memory/` directory. Searching in project A never returns results from project B.

## License

Apache 2.0
