explaingit

uddin-rajaul/brain-os-template

Analysis updated 2026-05-18

2Audience · vibe coderComplexity · 2/5LicenseSetup · easy

TLDR

A folder template that lets AI coding assistants build and maintain a persistent, structured knowledge base of markdown notes across sessions.

Mindmap

mindmap
  root((Brain OS))
    What it does
      Builds persistent wiki
      AI maintains cross-references
      Tracks session state
    Tech stack
      Markdown
      Obsidian
      Claude Code
    Use cases
      Give AI assistant long-term memory
      Organize project knowledge
      Track decisions over time
    Audience
      Developers using AI assistants

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 an AI coding assistant a persistent memory across sessions instead of starting from scratch.

USE CASE 2

Maintain a structured wiki of project decisions, patterns, and learned facts.

USE CASE 3

Set a custom personality and communication style for your AI assistant.

USE CASE 4

Track daily session notes and a running log of project changes.

What is it built with?

MarkdownObsidian

How does it compare?

uddin-rajaul/brain-os-template0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPython
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencevibe codergeneralgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Just clone the template and start an AI coding assistant inside the folder, no external dependencies or accounts needed.

Licensed under MIT, so anyone can use, modify, and redistribute it freely, including for commercial purposes, as long as the copyright notice is kept.

In plain English

Brain OS is a folder template for people who work with AI coding assistants like Claude Code, OpenCode, Cursor, or Codex, and want those tools to remember things across sessions. Instead of the AI re-reading all your notes every time you ask it something, the idea here is that the AI reads your source material once, pulls out the important facts, and writes them into a structured set of markdown pages that stay up to date over time. You read this wiki, and the AI is the one who keeps writing and maintaining it. The template is organized into folders with clear jobs. A RAW folder holds your original source documents, which the AI reads but never changes. Separate folders cover active projects, ongoing responsibilities, reference material, session notes, and an archive for things no longer active. A handful of instruction files, including one named for Claude and another for other assistants, tell the AI exactly how to read and update this structure, while a personality file lets you set the tone and style you want the assistant to use. Using it starts with cloning the template, opening your AI coding assistant inside that folder, and telling it to read the instructions and set itself up. From there, each working session begins with the AI reading a small file describing the current state, so it does not need much context to get going. As you work, the AI only writes new information when something genuinely new comes up, and at the end of a session it updates the current state file and adds an entry to a running log. The project argues that the tedious part of keeping a personal wiki is not writing it, but the ongoing bookkeeping of updating links and catching contradictions, which is exactly the kind of repetitive task an AI assistant does not get tired of doing. The template draws on ideas from note taking methods like PARA and Zettelkasten, and is compatible with Obsidian. It is released under the MIT license.</content>

Copy-paste prompts

Prompt 1
Read CLAUDE.md and Areas/workflows.md and initialize this memory vault.
Prompt 2
Explain the difference between the RAW folder and the wiki layer in this template.
Prompt 3
Walk me through customizing SOUL.md to set my assistant's tone and style.
Prompt 4
Summarize what happens automatically at the start and end of a session here.

Frequently asked questions

What is brain-os-template?

A folder template that lets AI coding assistants build and maintain a persistent, structured knowledge base of markdown notes across sessions.

What license does brain-os-template use?

Licensed under MIT, so anyone can use, modify, and redistribute it freely, including for commercial purposes, as long as the copyright notice is kept.

How hard is brain-os-template to set up?

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

Who is brain-os-template for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.