whatisgithub

What is marrow?

gnosislabstech/marrow — explained in plain English

Analysis updated 2026-07-26

4TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

Marrow is a self-hosted search engine for your AI chat history. It indexes your Claude Code and other AI transcripts so you can ask questions and get cited answers from your past conversations.

Mindmap

mindmap
  root((repo))
    What it does
      Ingests AI chat sessions
      Semantic and keyword search
      Answers with citations
      Runs on your own servers
    Supported sources
      Claude Code sessions
      Claude.ai exports
      ChatGPT exports
      Telegram and markdown
    Tech stack
      TypeScript
      Postgres with pgvector
      Voyage embeddings API
    Setup
      Demo mode without API key
      Needs Postgres for real use
      Config via env vars
    Use cases
      Search past debugging notes
      Find past design decisions
      Cite conversation sources

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search through hundreds of Claude Code sessions to find why a past decision was made.

USE CASE 2

Ask a question and get an answer with citations pointing to the exact conversation turn.

USE CASE 3

Index exports from ChatGPT, Claude.ai, or Telegram into one searchable database you control.

USE CASE 4

Try the tool instantly with a built-in demo that needs no API key.

What is it built with?

TypeScriptPostgreSQLpgvectorVoyage API

How does it compare?

gnosislabstech/marrow0labs-in/vision-linkadarsh-me/image-sdk
Stars444
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Demo mode needs no API key, but real use requires a Postgres database with pgvector and a Voyage API key.

You can use, modify, and distribute this software freely, including commercially, as long as you include the license notice and state any changes.

So what is it?

Marrow is a self-hosted search tool for people who use AI assistants like Claude Code during software development. Over time, you accumulate hundreds or thousands of conversation sessions filled with decisions, debugging notes, and the reasoning behind your code. Marrow ingests all of those sessions into a database you control and lets you ask questions about them. Every answer it produces includes citations pointing back to the specific conversation turn it came from. The project is built in TypeScript and runs entirely on infrastructure you own, with no data sent to a shared backend. The tool combines two kinds of search. Semantic search matches by meaning, so you can find related discussions even when the wording differs. Lexical search matches by exact keywords. Marrow blends both approaches and then optionally reranks the top results for better relevance. When you ask a question, it synthesizes a response with numbered citations to the source passages. Embeddings, which are the numerical representations of text used for semantic search, come from a service called Voyage by default, using your own API keys. You can try Marrow without any API key using a built-in demo that sets up a small synthetic corpus. After installing dependencies, a few commands spin up a local database, seed it with sample data, run a search, and tear it all down. For real use, you need a Postgres database with the pgvector extension, your own API credentials, and a set of session transcripts to index. Marrow can read Claude Code sessions by default, and also supports exports from Claude.ai, ChatGPT, Telegram, and generic markdown directories. The project is intentionally scoped to be just an engine: it ingests your data, retrieves relevant passages, and cites its sources. It does not build profiles, generate recommendations, or add analytics layers. Configuration is handled through environment variables and a single config file. Marrow is the open-core version of a retrieval engine that its maintainer, Gnosis Labs, runs in production. The analytics layers built on top remain closed, but the engine itself is fully open under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
How do I configure Marrow to index my Claude Code session transcripts and run a semantic search query with citations?
Prompt 2
Show me how to set up the Marrow demo with synthetic data so I can try searching without needing a Voyage API key.
Prompt 3
How do I import ChatGPT and Claude.ai exports into Marrow and what Postgres pgvector setup is required?
Prompt 4
How does Marrow blend semantic and lexical search, and how do I enable the optional reranking step for better results?

Frequently asked questions

What is marrow?

Marrow is a self-hosted search engine for your AI chat history. It indexes your Claude Code and other AI transcripts so you can ask questions and get cited answers from your past conversations.

What language is marrow written in?

Mainly TypeScript. The stack also includes TypeScript, PostgreSQL, pgvector.

What license does marrow use?

You can use, modify, and distribute this software freely, including commercially, as long as you include the license notice and state any changes.

How hard is marrow to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is marrow for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.