whatisgithub

What is claude-mega-brain?

guhcostan/claude-mega-brain — explained in plain English

Analysis updated 2026-05-18

121PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code plugin that automatically loads your project's own documented knowledge, like database schemas and metrics, into every session so the AI stops guessing.

Mindmap

mindmap
  root((claude-mega-brain))
    What it does
      Auto loads project knowledge
      Injects at session start
      Zero extra tool calls
    Tech stack
      Python
      Claude Code plugin
      Markdown frontmatter
    Use cases
      Accurate schema answers
      Document metrics and tables
      Faster lower cost sessions
    Audience
      Vibe coders
      Claude Code users

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

Give Claude Code accurate answers about your project's database schema without guessing.

USE CASE 2

Document metrics, tables, and services once and have them auto load in every session.

USE CASE 3

Reduce token usage and tool calls compared to manually searching a knowledge base.

USE CASE 4

Keep a lightweight changelog that surfaces recent project updates at session start.

What is it built with?

PythonClaude CodeMarkdown

How does it compare?

guhcostan/claude-mega-brain2417467487-hub/worldcuproichefkannofriend-source/lcb-baker-agent
Stars121121121
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/54/52/5
Audiencevibe coderpm foundergeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs as a Claude Code plugin via marketplace commands, requires writing markdown docs with a type field for the tool to detect.

MIT license: you can use, copy, modify, and distribute this freely, including commercially, as long as you keep the copyright notice.

So what is it?

claude-mega-brain is a plugin for Claude Code that gives the AI accurate knowledge about your specific project the moment a session starts, instead of letting it guess based on general training data. Normally, if you ask an AI assistant something like which database column stores a total, it might guess a common name that is wrong for your actual project. This tool fixes that by automatically loading your project's own documentation into the conversation from the start. It works by scanning your project for markdown files that include a small piece of structured information at the top, called frontmatter, describing what kind of document it is, such as a database table, a metric definition, or a service. When a session begins, it builds a compact summary of all these documented concepts and injects it automatically, so the AI already knows the exact schema, naming, and logic used in your project without needing to search for files or ask questions. The README includes a benchmark comparing this approach against having no context, against using Obsidian with a search plugin, and against just dumping raw markdown files into context. In their tests, this tool matched the best accuracy while using fewer tokens and responding faster, and it does this with zero extra tool calls, since the knowledge arrives already loaded rather than being fetched during the conversation. If no documented files are found in a project, the tool adds no meaningful delay. Setup is done through Claude Code's plugin system: you add the plugin marketplace entry, install the plugin, then run one setup command inside your project. Documentation files can live anywhere in the project, there is no dedicated folder requirement, and the format for writing them is a simple markdown file with a few standard fields like type, title, and description.

Copy-paste prompts

Prompt 1
Help me install claude-mega-brain as a Claude Code plugin in this project.
Prompt 2
Show me how to write an OKF markdown file documenting a database table.
Prompt 3
Explain how claude-mega-brain's SessionStart hook injects knowledge automatically.
Prompt 4
Walk me through setting up an index.md and log.md for this plugin.

Frequently asked questions

What is claude-mega-brain?

A Claude Code plugin that automatically loads your project's own documented knowledge, like database schemas and metrics, into every session so the AI stops guessing.

What language is claude-mega-brain written in?

Mainly Python. The stack also includes Python, Claude Code, Markdown.

What license does claude-mega-brain use?

MIT license: you can use, copy, modify, and distribute this freely, including commercially, as long as you keep the copyright notice.

How hard is claude-mega-brain to set up?

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

Who is claude-mega-brain for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.