@colbymchenry/cmem 0.2.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Colby Mchenry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+<div align="center">
+
+# 🧠 cmem
+
+### Your Claude Code Conversations, Remembered Forever
+
+**Don't just explore your code or folders—explore your conversations, or pick up where you left off.**
+
+**Semantic search • Auto-sync • 100% local**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
+
+<br />
+
+### Get Started
+
+```bash
+npx @colbymchenry/cmem
+```
+
+<sub>Interactive installer configures Claude Code automatically</sub>
+
+</div>
+
+---
+
+Ever closed your terminal and lost that perfect Claude conversation? The one where you finally figured out that tricky bug, or designed that elegant architecture?
+
+**cmem** gives Claude Code a long-term memory. Every conversation is automatically saved, indexed, and searchable—so you (and Claude) can pick up right where you left off.
+
+### MCP Integration
+
+> **Using CMEM MCP to fetch conversational data about previous chat sessions**
+>
+> Claude can search through your conversation history and synthesize answers—all without cluttering your main session context.
+
+![Query All Conversational History](https://github.com/user-attachments/assets/03accdee-7d3b-4d60-8b30-548e4a3a8101)
+
+---
+
+### Session Navigation
+
+> **Easily navigate between previous chat sessions and pick back up right where you left off**
+>
+> Browse, search, filter, rename, and restore any conversation with the interactive TUI.
+
+![Filter by Folder : Rename : Resume Sessions](https://github.com/user-attachments/assets/d0c8eb76-2d82-4740-81b7-4d8f88fad84f)
+
+#### Open all previous chat sessions in current directory
+
+![Open all sessions in current directory](https://github.com/user-attachments/assets/3783343c-815c-47ba-a6da-fb96cb25ee1b)
+
+
+## Why cmem?
+
+🧠 **Sub-Agent Summarization** — When Claude needs context from past sessions, cmem spawns a separate Claude instance to read and synthesize—keeping your main conversation context clean. Just like Explore agents, but for your conversation history.
+
+🔍 **Semantic Search** — Find conversations by meaning, not keywords. "That React hooks discussion" or "the database migration plan" just works.
+
+🤖 **Claude Can Remember** — Via MCP integration, Claude can search your past conversations. "What did we decide about auth last week?" Finally, context that persists.
+
+🔄 **Automatic Sync** — A background daemon watches your Claude Code sessions and keeps everything indexed in real-time.
+
+📦 **100% Local & Private** — Everything runs on your machine. No cloud services, no API keys, no external servers. Just SQLite + local AI embeddings.
+
+## Quick Start
+
+```bash
+npx @colbymchenry/cmem
+```
+
+The setup wizard will:
+1. Install `cmem` globally
+2. Download the embedding model (~130MB, one-time)
+3. Optionally set up auto-sync on login (macOS)
+4. Configure MCP server in `~/.claude.json` + permissions in `~/.claude/settings.json`
+
+That's it. Your conversations are now being remembered.
+
+## Requirements
+
+- **Node.js 18+**
+
+No other dependencies. The AI embedding model downloads automatically on first use and runs entirely in Node.js.
+
+## Usage
+
+```bash
+cmem                    # Browse sessions in beautiful TUI
+cmem --local            # Browse sessions from current folder only
+cmem search "query"     # Semantic search across all conversations
+cmem watch              # Start the sync daemon
+cmem stats              # See what's stored
+```
+
+## How It Works
+
+```
+Claude Code sessions → cmem watch daemon → SQLite + Vector DB
+                                                ↓
+                              Claude Code ← MCP Server ← Semantic Search
+```
+
+1. **Watch**: The daemon monitors `~/.claude/` for new/changed sessions
+2. **Index**: Conversations are parsed and embedded locally using `nomic-embed-text-v1.5`
+3. **Search**: Query by meaning using vector similarity
+4. **Remember**: Claude can access past conversations via MCP tools
+
+### Background Daemon
+
+The `cmem watch` daemon runs in the background and automatically syncs your Claude Code sessions:
+
+- **With daemon installed**: Sessions sync automatically whenever you use Claude Code
+- **Without daemon**: Run `cmem watch` manually, or sessions sync when you open the TUI
+
+On macOS, you can install the daemon to start automatically on login:
+```bash
+cmem install    # Enable auto-start
+cmem uninstall  # Disable auto-start
+```
+
+## MCP Tools
+
+Once configured, Claude Code gains these abilities:
+
+| Tool | What it does |
+|------|--------------|
+| `search_and_summarize` | **The star feature** — Ask a question, get an AI-synthesized answer from past sessions |
+| `search_sessions` | Find sessions by semantic similarity |
+| `list_sessions` | Browse recent sessions |
+| `get_session` | Retrieve full conversation history |
+| `get_session_context` | Get context to continue a past conversation |
+
+### How `search_and_summarize` Works
+
+```
+Main Claude Session                          cmem MCP Server
+       │                                            │
+       │  "What did we decide about auth?"          │
+       ├───────────────────────────────────────────►│
+       │                                            │
+       │                                   ┌────────┴────────┐
+       │                                   │ 1. Vector search │
+       │                                   │ 2. Find sessions │
+       │                                   │ 3. Read content  │
+       │                                   └────────┬────────┘
+       │                                            │
+       │                                   ┌────────┴────────┐
+       │                                   │ Spawn Claude CLI │
+       │                                   │ (sub-agent)      │
+       │                                   │                  │
+       │                                   │ Reads sessions,  │
+       │                                   │ synthesizes      │
+       │                                   │ answer           │
+       │                                   └────────┬────────┘
+       │                                            │
+       │  "Based on your Jan 15 session, you       │
+       │   decided to use JWT with refresh..."      │
+       │◄───────────────────────────────────────────┤
+       │                                            │
+```
+
+This keeps your main context clean—only the concise summary comes back, not the raw session content. Uses Haiku by default for speed, configurable to Sonnet or Opus.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `cmem` | Launch interactive TUI |
+| `cmem --local` | Launch TUI filtered to current folder |
+| `cmem setup` | Run setup wizard |
+| `cmem search <query>` | Semantic search |
+| `cmem list` | List all sessions |
+| `cmem restore <id>` | Output session context |
+| `cmem watch` | Start sync daemon |
+| `cmem install` | Auto-start daemon on login (macOS) |
+| `cmem uninstall` | Remove auto-start |
+| `cmem stats` | Storage statistics |
+| `cmem mcp` | Start MCP server |
+
+## TUI Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `↑/↓` or `j/k` | Navigate sessions |
+| `Enter` | Resume selected session |
+| `f` | Filter to selected session's folder |
+| `r` | Rename selected session |
+| `R` | Clear custom name |
+| `d` | Delete session |
+| `/` | Search |
+| `q` | Quit |
+
+## Data Storage
+
+All data is stored locally in `~/.cmem/`:
+- `sessions.db` — SQLite database with vector embeddings
+- `models/` — Downloaded embedding model (~130MB)
+
+Claude Code sessions are read from `~/.claude/`.
+
+## Tech Stack
+
+- **SQLite** + **sqlite-vec** — Embedded vector database
+- **transformers.js** + **nomic-embed-text-v1.5** — Local AI embeddings (768 dimensions, runs in Node.js)
+- **ink** — Beautiful terminal UI (React for CLI)
+- **MCP** — Model Context Protocol for Claude integration
+
+## License
+
+MIT
+
+---
+
+<p align="center">
+  <b>Stop losing your best conversations.</b><br>
+  <code>npx @colbymchenry/cmem</code>
+</p>

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }