npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

mimir-chat-index

v0.1.3

Published

Local-first AI chat memory index exposed through a CLI and MCP server.

Downloads

171

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

sherkhan-devsherkhan-dev

Keywords

aimemorymcpmodel-context-protocolcodexclaudecursor

Readme

Mimir

CI CodeQL License: ISC Documentation

Mimir gives your AI coding tools a searchable memory of past conversations. It indexes local Claude Code, Codex, and Cursor chats, redacts common secrets, and exposes the results through a CLI, an MCP server, and an optional self-hosted dashboard.

Mimir is local-first: your chat history stays on your machine unless you explicitly configure and run a cloud upload.

Links

Features

  • Search conversations across Claude Code, Codex, and Cursor.
  • Filter results by source, session, workspace, and date.
  • Give MCP-compatible assistants access to a single search-only tool.
  • Run without an OpenAI API key using deterministic local embeddings.
  • Optionally upload sanitized chunks to your own hosted Mimir instance.
  • Browse cloud conversations through a responsive web dashboard.
  • Inspect and test the hosted API through OpenAPI and Swagger UI.

Requirements

  • Node.js 20 or newer
  • npm
  • PostgreSQL with pgvector only when self-hosting the cloud service

Install

Install the npm package globally:

npm install --global mimir-chat-index

The package is named mimir-chat-index; the installed command is mimir.

mimir --version
mimir doctor

Quick start

Create Mimir's private local data directory, index your chats, and search them:

mimir init
mimir sync --source all
mimir query "what did we decide about authentication?"

Mimir automatically discovers supported chat history in its standard locations. You can index one source at a time:

mimir sync --source codex
mimir sync --source claude
mimir sync --source cursor

Run mimir status to see the local index and authentication state.

Search

Use natural-language queries and add filters when you need a specific conversation:

mimir query "database migration"
mimir query "pricing bug" --source claude --since 2026-06-01
mimir query "auth flow" --workspace /path/to/project
mimir query "release plan" --session SESSION_ID --json

Useful options:

| Option | Purpose | | --- | --- | | --limit <number> | Set the maximum number of results | | --source <source> | Filter by claude, codex, cursor, or fixtures | | --session <id> | Search within one session | | --workspace <path> | Search within one workspace | | --since <timestamp> | Include results after a date or Unix timestamp | | --until <timestamp> | Include results before a date or Unix timestamp | | --json | Return structured JSON |

Use mimir help query for the complete command reference.

Connect an MCP client

Mimir exposes one local MCP tool:

search_historical_chats

The tool accepts a query plus optional source, session, workspace, role, date, and result-limit filters. It is search-only and cannot modify local files or re-index conversations.

Add Mimir to Claude Code:

claude mcp add mimir -- mimir mcp

Add Mimir to Codex in ~/.codex/config.toml:

[mcp_servers.mimir]
command = "mimir"
args = ["mcp"]

For another MCP client, configure a local stdio server that runs:

mimir mcp

Local MCP does not require a bearer token. The process runs under your OS user account and reads the private local Mimir database.

Commands

| Command | Description | | --- | --- | | mimir init | Create the local Mimir data directory and database | | mimir sync | Index local AI chat history | | mimir query <text> | Search the local index | | mimir mcp | Start the local MCP server over stdio | | mimir login | Sign in to a hosted Mimir instance | | mimir upload | Upload pending sanitized chunks | | mimir status | Show local index and cloud authentication status | | mimir doctor | Diagnose the local installation | | mimir logout | Remove locally stored cloud credentials | | mimir reset-local | Reset local Mimir data |

Run mimir help <command> to inspect a command and its options.

Embeddings

Mimir defaults to deterministic development embeddings:

MIMIR_EMBEDDING_PROVIDER=dev

This mode requires no OpenAI subscription or API key. It is suitable for local setup and functional search, but its semantic ranking is less accurate than a production embedding model.

To use OpenAI embeddings:

MIMIR_EMBEDDING_PROVIDER=openai
OPENAI_API_KEY=your_api_key

Choose the provider before your first sync. Changing it later requires rebuilding the local index so every stored vector uses the same embedding model.

Optional cloud dashboard

The cloud service is optional and self-hostable. Mimir sanitizes chat chunks locally before upload; uploads happen only when you request them.

Sign in to your deployment:

mimir login --cloud-url https://mimir.example.com

Then sync and upload:

mimir sync --source all --upload

You can also run the steps separately:

mimir sync --source all
mimir upload --dry-run
mimir upload

Open https://mimir.example.com/dashboard to browse conversations and search uploaded memory. The dashboard uses the same device-login flow as the CLI and stores its browser session in an HttpOnly cookie.

Hosted MCP is available at https://mimir.example.com/mcp and requires a bearer token obtained through mimir login.

Self-host Mimir

For local cloud development:

git clone https://github.com/DevSherKhan/Mimir.git
cd Mimir
cp .env.example .env
docker compose up -d postgres
npm ci
npm run build
npm start

The service is available at:

The repository includes a Dockerfile, compose.yaml, and railway.json. See OPERATIONS.md for deployment configuration, migrations, backups, health checks, and incident procedures.

Configuration

| Variable | Description | Default | | --- | --- | --- | | MIMIR_HOME | Local data directory | ~/.mimir | | MIMIR_EMBEDDING_PROVIDER | dev or openai | dev | | OPENAI_API_KEY | Required for OpenAI embeddings | — | | MIMIR_CLOUD_URL | Hosted Mimir API URL | https://api.mimir.cloud | | DATABASE_URL | PostgreSQL connection string for the hosted service | — | | HOST | Hosted service bind address | 0.0.0.0 | | PORT | Hosted service port | 3000 | | MIMIR_DOCS_ENABLED | Enable Swagger UI and the OpenAPI endpoint | true |

Copy .env.example when running the hosted service locally. HTTPS is required for non-local cloud URLs.

Privacy and security

  • Chat data stays local until you explicitly upload it.
  • Common secret patterns are redacted before content is stored, embedded, or uploaded.
  • External chat databases are opened read-only or copied before parsing.
  • Local Mimir files use private permissions where the operating system supports them.
  • MCP diagnostics go to stderr so stdout remains reserved for JSON-RPC.
  • Hosted search and memory endpoints require authenticated access.

The local database and cloud credentials live under ~/.mimir by default. Do not commit or share that directory. Report vulnerabilities privately using SECURITY.md.

Development

git clone https://github.com/DevSherKhan/Mimir.git
cd Mimir
nvm use
npm ci
npm run check

Run commands directly from the TypeScript source during development:

npm run dev -- sync --source all
npm run dev -- query "database migration"
npm run dev -- mcp

See CONTRIBUTING.md for the development workflow and pull-request expectations.

Troubleshooting

Start with:

mimir doctor

If a native dependency was installed under a different Node.js version, reinstall Mimir using the active Node 20+ environment:

npm uninstall --global mimir-chat-index
npm install --global mimir-chat-index
mimir doctor

If you are developing from source, run nvm use, npm rebuild, and npm run build.

For command-specific help:

mimir help
mimir help sync
mimir help query

Community

Mimir is open source under the ISC license.