Metadata-Version: 2.4
Name: simple4u-memory
Version: 0.1.1
Summary: Persistent memory for Claude — MCP server with hierarchical memory, semantic search, and customizable persona
Author-email: Simple4u <nests@simple4uhq.com>
License: MIT
Project-URL: Homepage, https://github.com/Simple4uhq/simple4u-memory
Project-URL: Repository, https://github.com/Simple4uhq/simple4u-memory
Project-URL: Issues, https://github.com/Simple4uhq/simple4u-memory/issues
Keywords: claude,mcp,ai,memory,persistent,anthropic
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Dynamic: license-file

# Simple4u Memory — persistent memory for Claude

**An MCP server that gives Claude a memory that survives between sessions.**

Claude forgets you every time you close the chat. Simple4u Memory fixes that.

- **Hierarchical memory** — facts with categories (user, project, preference, reference, general)
- **Full-text search** — SQLite FTS5 across everything remembered
- **Session journals** — end-of-conversation notes you can read like a diary
- **Customizable persona** — edit `~/.simple4u-memory/persona.md` to shape behavior
- **Portable** — works in Claude Desktop, Claude Code, or any MCP client
- **Local-first** — your memory lives in `~/.simple4u-memory/` on your machine

Free and open source. MIT license.

## Install

```bash
pip install simple4u-memory
```

Or from source:

```bash
git clone https://github.com/Simple4uhq/simple4u-memory
cd simple4u-memory
pip install -e .
```

## Setup — one command

After install, run:

```bash
simple4u-memory init
```

This configures Claude Desktop and Claude Code automatically:
- Adds the MCP server entry to both client configs (idempotent)
- Writes a short guidance block to `~/.claude/CLAUDE.md` so Claude calls
  `get_persona()` at session start and uses `remember()` proactively

Restart Claude Desktop / Claude Code and the memory tools are live.

### Flags

```bash
simple4u-memory init --desktop        # Claude Desktop only
simple4u-memory init --code           # Claude Code only
simple4u-memory init --no-claude-md   # skip CLAUDE.md guidance block
simple4u-memory init --dry-run        # preview changes without applying
simple4u-memory uninstall             # remove all config entries
```

### Manual setup (alternative)

If you prefer editing configs by hand, add this to
`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS),
`%APPDATA%\Claude\claude_desktop_config.json` (Windows),
or `~/.claude/settings.json` (Claude Code):

```json
{
  "mcpServers": {
    "simple4u-memory": {
      "command": "simple4u-memory"
    }
  }
}
```

## Tools exposed

| Tool | Purpose |
|------|---------|
| `remember(text, category)` | Save a fact to long-term memory |
| `recall(query, limit)` | Search memories via full-text search |
| `list_memories(category)` | Browse what's remembered |
| `forget(memory_id)` | Delete a wrong/outdated memory |
| `journal(text)` | Write an end-of-session note |
| `recent_journals(days)` | Read recent journal entries |
| `get_persona()` | Return full persona + user context |

## Customize

Your memory lives in `~/.simple4u-memory/`:

```
~/.simple4u-memory/
├── persona.md            # Edit to change AI's behavior
├── memory.db             # SQLite + FTS5 (don't touch unless you know)
├── user/                 # Long-term facts about you
│   ├── identity.md       # Who you are (name, role, values)
│   ├── projects.md       # What you're working on
│   └── preferences.md    # How you like to work
└── journals/
    └── 2026-04-12.md     # End-of-session notes
```

Edit `persona.md` to change tone, rules, behavior. Edit `user/*.md` to pre-fill
facts the AI will know on every session.

## Environment

- `SIMPLE4U_MEMORY_HOME` — override the data directory (default `~/.simple4u-memory`)

## Uninstall

```bash
simple4u-memory uninstall   # remove configs from Claude Desktop + Code
pip uninstall simple4u-memory
rm -rf ~/.simple4u-memory   # optional — also delete stored memories
```

## Status

v0.1.1 — early release. Core memory tools + setup command work. Future: semantic
embeddings, memory hierarchies with decay, team-shared memories.

## Part of the Simple4u ecosystem

This is free and open source. If you want a full AI employee with this memory
built in — Gmail, Drive, reminders, daily intelligence, city/industry awareness —
check out [Simple4u](https://simple4uhq.com). $247/mo, 2 months free.

## License

MIT
