# pindoc

pindoc stores agent findings as typed, code-linked project records. Use it when a team needs reusable context across AI coding sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 12
- Author: var-gg
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/var-gg/pindoc
- Updated: 2026-09-01
- HTML: https://affpapa.org/en/nevibecode/mcp/pindoc

## What it does

pindoc is a self-hosted memory system for projects built with AI coding agents. It turns durable findings into typed records such as decisions, analyses, debugging paths, tasks, verification notes, and glossaries. Records may link to commits, files, line ranges, URLs, and other Pindoc records.

Its MCP workflow exposes tools including `pindoc.context_for_task`, `pindoc.artifact.propose`, and `pindoc.task.queue`. A single `/mcp` endpoint can serve several projects, while each project-scoped call carries `project_slug`.

Docker Compose starts Postgres, `pgvector`, the Pindoc daemon, and the Reader SPA. The documented Docker route requires Docker 27+; the first run also needs outbound HTTPS so the EmbeddingGemma model and runtime can be cached. Configure the client with `http://127.0.0.1:5830/mcp`.

## Requirements
- Needs: Docker
- Environment variables: `PINDOC_DATABASE_URL`, `PINDOC_BIND_ADDR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- preserve architectural decisions for later agents
- link debugging notes to commits and files
- give a new agent project context before editing
- inspect whether database migrations match the image
- refresh stale semantic indexes

## Example prompts
- Save the authentication decision in Pindoc and link it to the current commit.
- Ask Pindoc for task context related to `src/auth.ts` in project `my-project`.
- Add this follow-up task to the Pindoc queue with its related files.

## Similar
- [Lore](https://affpapa.org/en/nevibecode/mcp/agentkitai-lore.md) — MCP server · ★ 10
- [postgres](https://affpapa.org/en/nevibecode/skills/postgres.md) — skill · 1400 installs
- [postgres-hybrid-text-search](https://affpapa.org/en/nevibecode/skills/postgres-hybrid-text-search.md) — skill · 372 installs
- [grepai-storage-postgres](https://affpapa.org/en/nevibecode/skills/grepai-storage-postgres.md) — skill · 553 installs
- [hypermnesia-mcp](https://affpapa.org/en/nevibecode/mcp/hypermnesia-mcp.md) — MCP server · ★ 75
- [Memory Vault](https://affpapa.org/en/nevibecode/mcp/memory-vault.md) — MCP server · ★ 65

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md