gitwtfhub

wtf is aidimag?

anup-khanal/aidimag — explained in plain English

Analysis updated 2026-05-18

0DockerfileAudience · vibe coderComplexity · 2/5LicenseSetup · easy

TL;DR

A memory system that lets AI coding tools remember your codebase's decisions and rules across sessions, with evidence that checks if those memories are still true.

Mindmap

mindmap
  root((AI Dimag))
    What it does
      Persistent AI memory
      Verified claims
      Stored in .aidimag folder
    Tech stack
      Node.js
      npm package
      MCP server
    Use cases
      Cross session context
      Team conventions
      Guardrails
    Audience
      Vibe coders
      AI tool users
      Dev teams

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

Why would anyone build with this?

REASON 1

Keep an AI coding assistant consistent with your team's conventions across many separate chat sessions.

REASON 2

Store architectural decisions and past failed approaches so they are not repeated.

REASON 3

Generate context files like CLAUDE.md or .cursorrules automatically for tools that lack MCP support.

REASON 4

Enforce behavioral guardrails, like never touching certain files, before commits.

What's in the stack?

Node.jsnpmMCPDockerfileSQLite

How it stacks up

anup-khanal/aidimagag-grid/ag-charts-server-side-examplecaspermeijn/wallabag-test-server
Stars0
LanguageDockerfileDockerfileDockerfile
Last pushed2026-03-132024-12-24
MaintenanceMaintainedStale
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencevibe coderdeveloperdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Node 18 or newer, optional semantic search needs an OpenAI key or local Ollama.

Free to use for teams of ten or fewer people, larger teams or commercial use beyond that require a paid commercial license.

Wtf does this do

AI Dimag gives AI coding assistants like Claude, Cursor, Copilot, and Windsurf a persistent memory of your codebase that survives across separate chat sessions. Instead of re-explaining your project's decisions, conventions, and past mistakes every time you open a new session, this tool stores that knowledge as a set of claims saved in a folder called .aidimag right next to your code. What sets it apart is that each stored memory comes with evidence attached, such as a shell check, a linked commit, or a test result. A command called dim verify re-runs that evidence against your current repository, and if something that used to be true no longer holds, the memory is marked stale rather than quietly misleading the AI tool. Nothing gets added to memory automatically either: commits, pull requests, AI chat transcripts, and pasted documents get mined into proposals, but a human has to review and approve each one before it becomes an official memory. For tools that speak MCP, meaning Claude and Cursor, AI Dimag runs as a live MCP server offering search, proposal, and note-taking tools during a chat. For tools without MCP support, like Copilot and Windsurf, it can generate static context files such as .cursorrules, CLAUDE.md, and AGENTS.md that carry the same verified memory in a format those tools already read. Other features include guardrails, which are behavioral rules like never, ask first, or always that get enforced automatically, plus reusable step by step procedures called skills. There is also a team mode with a local server and sync command for sharing verified memory across a team, and a knowledgebase inbox that can summarize dropped in design docs or PDFs into memory entries. A web dashboard and editor extensions for VS Code and IntelliJ round out the tooling. Installation is a single npm command and requires Node 18 or newer. The project is free for teams of ten people or fewer under the Elastic License 2.0, with a commercial license required for larger or commercial use beyond that limit.

Yoink these prompts

Prompt 1
Install aidimag and run dim init in my repo, then explain what it created in the .aidimag folder.
Prompt 2
Set up aidimag as an MCP server in my Claude Code config and show me the mcpServers JSON I need.
Prompt 3
Use dim remember to save this decision as a memory with evidence I can verify later: [describe the decision].
Prompt 4
Run dim generate-context so my Copilot and Cursor setups both get the same verified project memory.

Frequently asked questions

wtf is aidimag?

A memory system that lets AI coding tools remember your codebase's decisions and rules across sessions, with evidence that checks if those memories are still true.

What language is aidimag written in?

Mainly Dockerfile. The stack also includes Node.js, npm, MCP.

What license does aidimag use?

Free to use for teams of ten or fewer people, larger teams or commercial use beyond that require a paid commercial license.

How hard is aidimag to set up?

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

Who is aidimag for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.