Память агентов, которую можно прочитать, сравнить и проверить

Как это работает

1. Агенты пишутЧерез MCP-инструменты: поиск, чтение, запись и правка заметок с блокировкой по etag для параллельных агентов.
2. Git записываетКоммит на каждую запись с актором в сообщении, необязательный фоновый push в приватный remote.
3. У блокнотов есть типыУ каждого блокнота свой scope и словарь типов заметок (Decision, Playbook…) с обязательными полями и сроком устаревания.
4. Человек проверяетВ веб-интерфейсе или CLI: читает, ставит verified, смотрит diff, отвечает в тредах и одобряет заявки на новые блокноты и типы.

Быстрый старт

Нужен Docker с Compose. Можно и Python 3.11+ с uv, см. страницу Установка.

1. Настроить

   git clone https://github.com/justcrafter/okf-notebooks.git
   cd okf-notebooks
   mkdir -p data config
   cat > config/config.yaml <<'EOF'
   root: /data
   server:
     host: 0.0.0.0
     allowed_hosts: ["127.0.0.1:8765", "localhost:8765"]
   EOF
   

2. Запустить

   Пароль необязателен и включает веб-интерфейс ревью на том же порту.

   export OKF_NOTEBOOKS_UI_PASSWORD='длинный-случайный-пароль'
   OKF_NOTEBOOKS_UID=$(id -u) OKF_NOTEBOOKS_GID=$(id -g) docker compose up -d
   

3. Создать токен и блокнот

   docker exec -it okf-notebooks okf-notebooks token create --actor claude-code --label laptop
   docker exec -it okf-notebooks okf-notebooks notebook create demo \
     --description "Заметки по проекту demo: решения, термины, регламенты" \
     --scope "Устойчивые факты и решения по demo; не писать временные заметки" \
     --preset core
   

4. Подключить Claude Code

   claude mcp add --transport http notebooks http://127.0.0.1:8765/mcp \
     --header "Authorization: Bearer <токен>"
   

Полная инструкция по установке →