ML

manhhailua/lorekeep

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

20 stars 2 forks Качество 63 Тренд 18MIT

Lorekeep — график временных знаний для агентов ИИ через MCP

Обзор

Lorekeep компилирует Markdown из нескольких пространств имен в детерминированный график fact.jsonl, проекты, которые графируют в вики Obsidian/Tolaria, и подвергает компактную поверхность MCP, связанную с пространством имен, кодирующим агентам (Claude Code, Cursor, Codex, opencode, Grok Build, Qoder, GitHub Copilot, Command Code). Агенты также могут предлагать факты во время сессии; предложения попадают в журналы только с приложениями и становятся видимыми после решения с уверенностью. Работа LLM происходит во время компиляции или явно запрашиваемого глубокого импорта. Обычные запросы графов, журнал пишет, разрешает, генерация вики, lint и проверки статуса не называют другой LLM. Lorekeep подходит для одного человека, использующего несколько кодирующих агентов и несколько устройств, с важным текущим ограничением: резервное копирование / синхронизация Git является последовательным. Одновременное редактирование одного и того же документа или журнала может потребовать ручного разрешения конфликта. Общий аутентифицированный командный сервер - это работа дорожной карты, а не отгруженная возможность.

Обзор (машинный перевод)

** Файл-суверенный график временных знаний, совместно используемый вами и вашим кодом Агенты по MCP**

Lorekeep компилирует Markdown из нескольких пространств имен в детерминированный facts.jsonl Граф, проекты, которые граф в человекочитаемый Обсидиан/Толария wiki, и подвергает компактную поверхность MCP с пробелом имен кодирующим агентам (Claude Code, Cursor, Codex, opencode, Grok Build, Qoder, GitHub Copilot, Командный код. Агенты могут также предлагать факты во время сессии; Они попадают в журналы только с приложениями и становятся видимыми после уверенного решения.

Работа LLM происходит во время компиляции или явно запрашиваемого глубокого импорта. Обычные графические запросы, журнал пишет, разрешает, генерация wiki, lint и Проверка статуса не вызывает другой LLM.

Что доступно сегодня

Область | Текущее поведение [скрыто] [скрыто] | Компиляция | raw/ /*.md → Схема-ограниченное извлечение → разрешение → отсортированный facts.jsonl + манифест + вики | Восемь инструментов MCP плюс пассивная схема, пространство имен и ресурсы статуса | Разрешение | Фильтрация пространства имен по умолчанию через одну ScopedGraph точку удушения | Полуоткрытые окна валидности плюс снимок, история и запросы на изменение

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Lorekeep

A file-sovereign, temporal knowledge graph shared by you and your coding agents over MCP.

Lorekeep compiles Markdown from multiple namespaces into a deterministic facts.jsonl graph, projects that graph into a human-readable Obsidian/Tolaria wiki, and exposes a compact namespace-scoped MCP surface to coding agents (Claude Code, Cursor, Codex, opencode, Grok Build, Qoder, GitHub Copilot, Command Code). Agents can also propose facts during a session; proposals land in append-only journals and become visible after a confidence-gated resolve.

The LLM work happens during compile or an explicitly requested deep import. Ordinary graph queries, journal writes, resolve, wiki generation, lint, and status checks do not call another LLM.

What is available today

Area Current behavior
Compile raw//*.md → schema-constrained extraction → resolve → sorted facts.jsonl + manifest + wiki
Query Eight MCP tools plus passive schema, namespace, and status resources
Permission Deny-by-default namespace filtering through one ScopedGraph chokepoint
Time Half-open validity windows plus snapshot, history, and change queries
Agent input Native session-end capture where available; debounced idle/turn fallback for opencode and Command Code
Agent writes Namespace-enforced, confidence-gated journals; no direct graph mutation
Automation Watch raw docs, journals, memories/transcripts, agent wiring, backup sync, and restart after an external package upgrade
Human view Deterministic, readable Markdown wiki for Obsidian and Tolaria
Operations Runtime logs, redacted support bundles, install diagnostics, and optional automatic GitHub issues

Lorekeep is suitable for one person using several coding agents and several devices, with an important current constraint: Git backup/sync is sequential. Simultaneous edits to the same raw document or journal can still require manual conflict resolution. A shared authenticated team server is roadmap work, not a shipped capability.

Get started

1. Install

macOS / Linux (one-liner — auto-detects uv, pipx, or pip):

curl -fsSL https://raw.githubusercontent.com/manhhailua/lorekeep/main/scripts/install.sh | bash

Windows (PowerShell):

pip install --user lorekeep

Or with uv (all platforms):

uv tool install lorekeep

Verify the installation succeeded before continuing:

lorekeep version    # should print a version number

If lorekeep is not found, open a new terminal (so PATH updates take effect) or add ~/.local/bin to your PATH manually.

2. Initialize

lorekeep init

init sets up config, schema, provider, agent wiring, compiles any existing

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →