Name: heropen
Author: KSMN Studio

Why heropen?

Every new agent session starts from scratch — project context, tool preferences, past learnings, all gone. heropen gives your agent a memory that persists across sessions, so you never have to repeat yourself.

🧠

Persistent Memory

Your agent remembers projects, codebase decisions, tools, and conventions across sessions.

🔒

100% Local

SQLite + vector search. No cloud, no API calls, no data leaving your machine.

🔌

MCP Protocol

Works with any agent that supports the Model Context Protocol. Auto-detect and set up in one command.

Quick Start

      # Install

      $ pip install heropen

      $ heropen auto-setup

      # Save a memory

      $ heropen add "Project uses FastAPI + SQLAlchemy, tests with pytest"

      # Search memories

      $ heropen search "project tech stack"

      # Status

      $ heropen status

Features

✅ Automatic agent detection — heropen auto-setup detects Claude Code, Cursor, Windsurf, Cline and configures MCP automatically
✅ Semantic search — Vector embeddings power natural language memory retrieval, not just keyword matching
✅ CRUD operations — Add, search, update, list, and delete memories via CLI or MCP tools
✅ Multiple embedding backends — Built-in lightweight embeddings (fastembed) or plug in your own
✅ Cross-platform — Linux, macOS, Windows. Works out of the box.
✅ Open source — MIT licensed. No vendor lock-in, no hidden costs.

Supported Agents

heropen works with any agent that supports the MCP protocol. Automatically detected:

Claude Code

Cursor

Windsurf

Cline

Continue.dev

Any MCP Agent

Get Started Now

One command, zero config. Your agent will thank you.

$ pip install heropen && heropen auto-setup

📖 Full Documentation ⭐ Star on GitHub

MIT License · KSMN Studio · GitHub · PyPI