Apache-2.0 · local-first · zero external services

ContinuityOS

Один продукт — шесть слоёв. Память (L1) — фундамент; поверх неё continuity, council, twin, control/governance и autopoiesis держат непрерывность между сессиями и моделями. Эта страница — про слой памяти.

Долговременная гибридная память для AI-агентов и человека. Структурный поиск (папки + ключевые слова) + семантический (вектор) — в одном локальном SQLite-файле. Ничего не уходит наружу.

Одна истина между сессиями, между моделями (Claude / GPT / Gemini) и версиями кода — знание из одной сессии доступно другой и сверяется с «code reality» репозитория. Плюс observability-слой: tamper-evident журнал решений агента (что сделал, почему, откат).

$pip install continuityos

Проблема, которую решает

Claude / ChatGPT / любой агент забывает всё между сессиями — каждый раз начинает с нуля. ContinuityOS ставится локально и хранит то, что важно: кто ты, какие проекты, какие правила, какие решения уже принял. Когда задаёшь новый вопрос — нужная память подтягивается сама, по смыслу или по словам. Структурно, как файлы в папках, чтобы и агент, и человек могли с ней работать.

Один ContinuityOS — шесть слоёв

Память — это слой L1, фундамент. Всё остальное держит непрерывность между сессиями, моделями и версиями кода. То, что на других страницах называют «governance gateway» — это слой L5 (Control Plane) того же продукта, а не отдельный инструмент.

L1 · Memory

Гибридный recall: структура (FTS + namespace) + семантика (вектор). ← эта страница.

L2 · Continuity

canon · frontiers · open loops · checkpoints · анти-дрифт doctor · handoff. Fork-aware: память форкается вместе с песочницей агента.

L3 · Council

Много агентов + человек на одной памяти: authority 1–5, роли, права по namespace.

L4 · Twin

Цифровой двойник: профиль из памяти, предсказание позиции, alignment против канона.

L5 · Control / Governance

Preflight ALLOW·DENY·CONFIRM по твоему канону · correct · redact · rollback · tamper-evident аудит. → governance-слой детально

L6 · Autopoiesis

Иммунная система: doctor проверяет, что память, идентичность и цель на месте.

Почему именно так

🔀 Гибридный recall

Только ключевые слова — мимо перефразировок. Только вектор — мимо точных фактов и структуры. ContinuityOS смешивает оба: 0.6·семантика + 0.4·keyword (настраивается).

🗂️ Структура как папки

Память живёт в namespace: identity, projects, rules, facts, events, notes — или свои. Поиск можно сузить, человек может листать.

🤖 Для агентов и людей

Из кода, из CLI, из MCP-клиента (Claude Desktop / Claude Code) или по крошечному HTTP API. Агент сам помнит и вспоминает.

🔒 Local-first & приватно

Ядро — только stdlib, ноль обязательных зависимостей и сервисов. Один SQLite-файл на твоём диске. Ни облака, ни аккаунта, ни телеметрии.

Как работает

remember(text, namespace, tags) │ ▼ ┌───────────────────────────────┐ │ Store │ один локальный SQLite-файл │ items + FTS5 + vectors │ └───────────────────────────────┘ ▲ recall(query) │ ГИБРИДНЫЙ ранг ┌───────────┴───────────┐ структурный / keyword семантический / вектор (FTS5 + namespace) (cosine по эмбеддингам) └───────────┬───────────┘ смешанный score → top-k

Эмбеддинги подключаемые: дефолтный HashingEmbedder детерминированный и полностью офлайн (приватность + тесты). Для максимального качества передай любой str → list[float] (например sentence-transformers).

Quick start

CLI

cos remember "Robert prefers Apache-2.0" -n rules -t license
cos remember "ContinuityOS = FTS + vectors" -n projects
cos recall  "which license should I pick?"
# 0.54 [rules] Robert prefers Apache-2.0  (semantic + keyword)
cos namespaces

Python

from continuityos import Memory

m = Memory("memory.db")
m.remember("grid K=0.04 led +$1405/3d",
           namespace="facts", tags=["trading"])

for h in m.recall("best grid setup", k=3):
    print(h.score, h.namespace, h.text)

# готовый блок в промпт агента:
print(m.context("what about grid trading?"))

MCP-сервер (Claude Desktop / Claude Code)

{
  "mcpServers": {
    "continuityos": {
      "command": "cos",
      "args": ["--db", "~/.continuityos/memory.db", "serve"]
    }
  }
}

Тулзы: rememberrecallcontextforgetlist_namespaces — агент подтягивает нужную память сам и дописывает новые факты по ходу.

Docker

docker compose up -d   # HTTP API на :8077, память в ./cos-data

Честно про статус

v0.1 — рабочее ядро: движок (store + FTS + вектор + гибридный recall), CLI, MCP-сервер, HTTP API, тесты. Дальше: инкрементальный векторный индекс для больших хранилищ, реранкинг, импорт-адаптеры (экспорты чатов, заметки), веб-браузер памяти.

Open-source, Apache-2.0 — свободно встраивай куда угодно, включая коммерческое. Никаких данных мы не собираем.