Karpathy Wiki Bundle

Система долговременной памяти для Claude Code — всё в одном репозитории.

Основана на архитектуре Андрея Карпати: вместо RAG — предварительная компиляция знаний в структурированные markdown-статьи.

---

Что внутри

Компонент	Откуда	Назначение
memory-compiler/	coleam00/claude-memory-compiler	Хуки SessionStart/SessionEnd/PreCompact — автозахват знаний из каждой сессии
skills/	Ar9av/obsidian-wiki	14 скиллов: /wiki-ingest, /wiki-query, /wiki-update и т.д.

Всё включено в репо — внешние зависимости не нужны.

---

Установка

Требования

• Claude Code установлен
• uv установлен (curl -LsSf https://astral.sh/uv/install.sh | sh)

Один скрипт

git clone https://github.com/sergeyramas/karpathy-wiki-bundle
cd karpathy-wiki-bundle
bash install.sh

Скрипт:

1. Устанавливает memory-compiler → ~/.claude-memory-compiler/
2. Копирует скиллы → ~/.claude/skills/
3. Регистрирует хуки в ~/.claude/settings.json
4. Устанавливает Python-зависимости через uv

После установки — перезапусти Claude Code.

Опционально: настрой часовой пояс

# ~/.claude-memory-compiler/scripts/config.py
TIMEZONE = "Europe/Moscow"   # или "America/New_York", "UTC" и т.д.

---

Первый запуск

После установки в Claude Code:

/wiki-setup              — создаёт Obsidian vault (спросит путь)
/claude-history-ingest   — импортирует прошлые сессии в wiki

---

Использование

Команда	Что делает
/wiki-update	Синхронизирует текущий проект в wiki
/wiki-query	Задаёт вопрос базе знаний
/wiki-status	Статистика: что загружено, что ожидает
/wiki-ingest	Загружает документы/файлы в wiki
/wiki-lint	Проверяет здоровье wiki (7 проверок)
/wiki-rebuild	Пересобирает wiki с нуля
/claude-history-ingest	Импортирует историю Claude-сессий
/cross-linker	Находит незаполненные wikilinks
/tag-taxonomy	Нормализует теги

Автоматически (без действий)

• SessionEnd — после каждой сессии Claude Code → знания захватываются в daily/YYYY-MM-DD.md
• PreCompact — перед авто-сжатием контекста → ничего не теряется
• SessionStart — в начале каждой сессии → knowledge/index.md инжектируется в контекст

---

Как работает (идея Карпати)

Ты общаешься с Claude
        ↓
SessionEnd hook захватывает разговор
        ↓
flush.py (фон) → Claude решает что важно → daily/2026-04-10.md
        ↓
/wiki-update или авто-компиляция в 18:00
        ↓
knowledge/concepts/*.md  +  knowledge/connections/*.md
        ↓
SessionStart → index.md инжектируется в следующую сессию
        ↓
Claude помнит всё из прошлых сессий без RAG

Почему без RAG: При 50–500 статьях LLM, читающий index.md, умнее cosine similarity. Понимает что ты спрашиваешь, строит синтез. RAG нужен только от ~2000+ статей.

---

Структура после установки

~/.claude-memory-compiler/
├── hooks/
│   ├── session-start.py     # инжектирует knowledge/index.md в сессию
│   ├── session-end.py       # захватывает разговор → daily/
│   └── pre-compact.py       # захват перед авто-сжатием контекста
├── scripts/
│   ├── compile.py           # daily/ → knowledge/ (через Claude SDK)
│   ├── query.py             # вопрос к базе знаний
│   ├── lint.py              # 7 проверок здоровья
│   ├── flush.py             # фоновое извлечение памяти
│   ├── config.py            # пути и часовой пояс
│   └── utils.py
├── knowledge/
│   ├── index.md             # мастер-каталог — главный механизм поиска
│   ├── log.md               # лог компиляций
│   ├── concepts/            # атомарные статьи знаний
│   ├── connections/         # связи между концептами
│   └── qa/                  # ответы на вопросы (накапливаются)
├── daily/                   # исходники — логи разговоров (только добавление)
├── AGENTS.md                # схема для LLM — как компилировать
└── pyproject.toml

~/.claude/skills/
├── wiki-setup/
├── wiki-ingest/
├── wiki-query/
├── wiki-update/
├── wiki-lint/
├── wiki-status/
├── wiki-rebuild/
├── wiki-export/
├── claude-history-ingest/
├── cross-linker/
├── data-ingest/
├── tag-taxonomy/
├── llm-wiki/
└── skill-creator/

---

Для агентов (машиночитаемый формат)

INSTALL_KARPATHY_WIKI:
  repo: https://github.com/sergeyramas/karpathy-wiki-bundle
  commands:
    - git clone https://github.com/sergeyramas/karpathy-wiki-bundle /tmp/karpathy-wiki-bundle
    - cd /tmp/karpathy-wiki-bundle && bash install.sh
  requires:
    - uv (https://astral.sh/uv)
    - claude-code (~/.claude/ must exist)
  installs_to:
    - ~/.claude-memory-compiler/   (memory compiler + hooks)
    - ~/.claude/skills/            (14 wiki skills)
    - ~/.claude/settings.json      (hook registration)
  post_install:
    - restart Claude Code
    - optional: set TIMEZONE in ~/.claude-memory-compiler/scripts/config.py
    - first run: /wiki-setup, then /claude-history-ingest
  skills_available:
    - /wiki-setup, /wiki-ingest, /wiki-query, /wiki-update
    - /wiki-lint, /wiki-status, /wiki-rebuild, /wiki-export
    - /claude-history-ingest, /cross-linker, /data-ingest
    - /tag-taxonomy, /llm-wiki, /skill-creator

---

Источники

• Andrej Karpathy — LLM KB Architecture
• coleam00/claude-memory-compiler
• Ar9av/obsidian-wiki