gitwtfhub

wtf is cartographer?

beppetemp/cartographer — explained in plain English

Analysis updated 2026-05-18

8GoAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

A Go MCP server that lets an AI agent safely build and maintain its own Markdown knowledge base over time, enforcing validation and git commits.

Mindmap

mindmap
  root((cartographer))
    What it does
      Agent editable wiki
      MCP governed writes
      Git backed history
      Audit log
    Tech stack
      Go
      MCP protocol
      Git
      Ollama search
    Use cases
      Persistent agent memory
      Shared team wiki
      Change audit trail
    Audience
      Developers
      Agent builders

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

Give an AI coding agent a persistent, versioned knowledge base it can grow across sessions.

REASON 2

Run a shared team wiki that multiple agents write to safely over HTTP.

REASON 3

Keep an audit trail of every change an agent makes to its own notes.

What's in the stack?

GoMCPGitOllama

How it stacks up

beppetemp/cartographerd4l3k/turtlejakecoffman/rest
Stars888
LanguageGoGoGo
Last pushed2018-01-272021-05-21
MaintenanceDormantDormant
Setup difficultymoderatemoderateeasy
Complexity4/52/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs Go 1.26+ or a prebuilt binary, plus git, semantic search needs a separate Ollama server.

Use freely for any purpose, including commercial use, as long as you include the license and note any changes you made.

Wtf does this do

Cartographer is a Go based server that acts as a governance layer for what its author calls an Agentic Wiki. The idea is that an AI agent should be able to build and maintain its own knowledge base over time instead of relying only on retrieval that has no memory between sessions. The problem with letting an agent write directly to files is that things break: links go stale, history gets lost, and content can get silently corrupted. Cartographer solves this by sitting between the agent and the files. The agent never touches the wiki's files directly. Instead it talks to Cartographer through the Model Context Protocol, known as MCP, and the server enforces rules such as validating writes, checking links, and committing every change to git one at a time. The wiki itself is just a folder of Markdown files with YAML frontmatter, following an open format called OKF, so it can still be opened in any editor or in Obsidian, with no lock-in to Cartographer itself. There are two ways to run it. Local Core is meant for a single agent using a local connection and local git, keeping things simple. The Server profile supports multiple knowledge bases at once over HTTP, with token based authentication and optional semantic search powered by Ollama. Other features include a read and search toolset for browsing the wiki, an audit log that is cryptographically signed and cannot be edited after the fact, support for syncing a wiki to a remote git repository automatically, and a configurator that can set up MCP connections for tools like Claude Code, Codex CLI, Kiro, and OpenCode. It installs through Homebrew, a shell script, or directly with the Go toolchain if you have Go 1.26 or newer. Once installed, a single command starts the server pointed at a knowledge base folder, either for local use or as an HTTP service. The project is licensed under Apache 2.0. It is explicitly labeled as beta software, so its tools and configuration may still change before a stable 1.0 release.

Yoink these prompts

Prompt 1
Help me install Cartographer and connect it to Claude Code as an MCP server.
Prompt 2
Walk me through setting up a Local Core Cartographer instance for a single agent.
Prompt 3
Explain how Cartographer's commit gate and lint checks keep a Markdown wiki from breaking.

Frequently asked questions

wtf is cartographer?

A Go MCP server that lets an AI agent safely build and maintain its own Markdown knowledge base over time, enforcing validation and git commits.

What language is cartographer written in?

Mainly Go. The stack also includes Go, MCP, Git.

What license does cartographer use?

Use freely for any purpose, including commercial use, as long as you include the license and note any changes you made.

How hard is cartographer to set up?

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

Who is cartographer for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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