CarpeOS

English · 한국어

Захватывайте контекст. Приумножайте знания.

CarpeOS — это персональная операционная система знаний для работы с ИИ‑ассистентами. Она захватывает агентные сессии с провенансом, формирует устойчивое значение в момент записи (дешёвые правила adj_v3 плюс пост‑захватный Agentic Layer), по умолчанию делает решения со статусом promoted доступными для поиска и помогает вам и вашим агентам позже извлекать этот контекст через MCP, CLI и Obsidian — всё это локально‑first, без обязательного ручного просмотра на happy path.

Она хранит след того, откуда каждый фрагмент появился, не превращая каждый дамп сессии в «память».

Последний пакет: @innocarpe/carpeos@6.7.8 (CHANGELOG · v6.7.8).

Сайт

Посетите сайт CarpeOS — обзор продукта, системная модель, путь установки и руководство по публичной документации.

Related MCP server: Hicortex - AI Fleet Memory

Зачем это существует

Вы завершаете долгую агентную сессию с реальным решением, наполовину готовым планом или путём к багу, который не хотите заново открывать. Через неделю этот контекст разбросан по истории чата, скролу терминала и нескольким заметкам — и следующий агент не имеет ничего из него.

CarpeOS — это попытка сохранить контекст в одном месте, которое вы контролируете, с достаточной структурой, чтобы «мы решили X» не считалось тем же самым, что «модель когда‑то предложила X».

Публичный код. Приватные знания.
В этом репозитории — проектирование, спецификации и реализация. Ваши реальные и проекты, и проекты, и работы, и учётные данные остаются с вами и что remains.

Для кого это

Полезно, если вы:

• Переключаетесь между агентами (Codex, Claude Code, Grok Build, …) и не нуждаетесь ни в отдельной памяти для каждого

• Нуждаетесь в том, чтобы решения недельной давности оставались доступны, а не потерялись в старом транскрипте

• Беспокоитесь, является ли что‑то черновиком, отклонён или реально принято, когда ищете это

• Хотите локальные данные по умолчанию и синхронизацию, который вы запускаете сами, если нужно

• Предпочитаете явные схемы и тесты как «чёрного ящика» или «memory product»

Пока не полированный пользовательский app. Не облачный SaaS. Не альтернатива вашему редактору. Скорее, работающая коммуникация для тех, кто уже живёт в агентных workflows.

Что в коробке

Захват из инструментов, которые вы уже используете

Хуки на схеме события жизненного цикла Codex, Claude Code и Brok Build в общий формат захвата. Raw — в зашифрованном хранилище; журнал событий и сообщения и ссылки. Host‑hooks остаются fail‑open и быстрыми.

Формирование смысла до того как «память» (два уровня)

После захвата два пути могут в момент записи определить, что одно держать:

Agent(ADR 0018): verified allowlisted extracts (decision / constraint / preference) по умолчанию повышаются когда E5 обосновывает утверждение в цитируемых разделах — без клика человека. procedure и fact_candidate остаются склонны к hold. Люди откатывают ошибки, при желании accept-claim, или снимают hold — для корректировки.

heское рассмотрение hold остается политико‑уверенного и append‑only на обеих плоскостях. Ни один путь автоматически не создаёт AcceptanceDecision.

adj_v3 основа (3.2+) и предварительный просмотр B0 policy reconciliation остаются доступными:

carpeos adjudicate reconcile-policy \
  --from-policy adj_v1 --to-policy adj_v3 \
  --trust-zone tz_synthetic --limit 100

B0 — работает только с метаданными и поддерживает только эти флаги: --from-policy, --to-policy, --trust-zone, --limit. --apply, --apply-safe-subset, подтверждения, квитанции и суперсессия не поддерживаются. Работа над B1 write/apply/receipt отложена. Dogfood поток и результаты имеют синтетический и одноразовый характер.

Модель, которая не стирает статус

Доказательство — не утверждение. Утверждение не становится true просто потому, что оно существует. Принятие (acceptance) и замена (supersession) — отдельные записи. Поиск может показать, что является решённым, что предложенным, а что заменённым — без взбивания в один парадан векторного текста.

flowchart LR
  E[EvidenceArtifact] --> Feed[agentic_capture_feed]
  E --> J[adj_v3 optional]
  Feed --> Ag[Agentic E1–E8]
  Ag -->|promote-when-verified| O[Observation active]
  Ag -->|hold side channel| H[Observation draft]
  Ag -->|reject| R[Evidence only]
  J -->|promote| O
  J -->|hold| H
  O --> C[Claim draft optional]
  C --> A[AcceptanceDecision<br/>human only]
  O --> S[Supersession<br/>human retract]
  A --> F[Accepted fact<br/>derived at query time]
  S --> F

Интерфейсы для людей и агентов

• CLI — capture-hook, extract, adjudicate, agentic (run / timer / retract / golden / graphrag…), retrieval rebuild, memory search|get|context-pack (по умолчанию promoted‑only; --include-held опционально), sync status|push|pull|once|cycle.

• MCP (stdio) — восемь локальных инструментов (memory_search, memory_get, memory_context_pack, memory_trace, memory_timeline, memory_related, memory_capture, memory_propose_claim).

• Постоянный agentic — опциональный таймер на 30 минут: carpeos agentic timer install (сеть выключена по умолчанию)

• Obsidian‑проекция — Markdown‑файлы, созданные из локального хранилища (только проекция; не источник истины)

• OKF v0.2‑экспорт как проекция — carpeos okf export|rebuild пишет переносимый бандл, ограниченный trust‑zone и по умолчанию promoted/active; это не каноническое хранилище и не путь импорта (guide).

Локально в‑первую очередь, синхронизация опциональна

Каждый машина пишет в local outbox. Есть разворачиваемый код Cloudflare Worker/D1/R2, если вам нужна приватная синхронизация — плюс ограниченный carpeos sync cycle для операторских циклов. Проекции всегда можно пересобрать из журнала событий.

flowchart TB
  subgraph devices [Your machines]
    H1[Agent hooks]
    CLI[carpeos CLI]
    MCP[MCP stdio server]
    OBS[Obsidian projection]
  end

  subgraph local [Local runtime]
    OUT[Encrypted outbox + local store]
    RET[Search + recheck]
  end

  subgraph private [Optional private sync]
    W[Cloudflare Worker]
    D1[(D1 metadata)]
    R2[(R2 encrypted blobs)]
  end

  H1 --> OUT
  CLI --> OUT
  OUT --> RET
  RET --> MCP
  RET --> OBS
  OUT <--> W
  W --> D1
  W --> R2

Как все соединяется

flowchart TB
  A[Agent hooks<br/>fail-open] --> B[Local capture<br/>no LLM]
  B --> F1[agentic_capture_feed]
  B --> F2[adj_v3 optional]
  F1 --> T[30m timer or<br/>agentic run]
  T --> G[E5 ground + gate<br/>promote-when-verified]
  G --> C[Event store]
  F2 --> C
  C --> D[Promoted / active meaning]
  C --> E[Projections]
  D --> M[MCP / CLI / Obsidian]
  E --> M
  H[Human retract / accept<br/>correction only] -.-> C

Правила, которые стоит знать заранее:

1. Журнал событий append‑only; статусы событий также append‑only по версии политики.

2. По умолчанию ищется promoted/active значение — не каждая захваченная сессия.

3. Agentic promote‑когда‑verified замыкает цикл без обязательного человека в контуре (ADR 0018); формальный AcceptanceDecision по‑прежнему только человек и не обязателен.

4. «Принято» вычисляется во время запроса — мы не перезаписываем утверждение на месте.

5. Чувствительные данные в открытом виде не хранятся в теле событий.

6. Trust zones — настоящие границы изоляции, а не бирки для винила.

7. Заметки, векторы и контекст — пакеты можно удалять и пересобрать; это не каноническое хранилище.

Подробнее: Архитектурный обзор, Agentic Layer, Ёмкость памяти, ADR 0017, ADR 0018, ADRs, spec/v1.

Ёмкость памяти (всего (total) против активной)

CarpeOS разделяет сколько личного знания вы храните от сколько агент загружает прямо сейчас:

Контексты используют разрежённое эксперт‑слот распределение (default 16 слотов) и cache‑friendly порядок разделов, чтобы принятые факты оставались впереди of active черновиков. См. заметка по memory capacity и capacity master plan. Retrieval‑first graph/hybrid recall, включая cross‑repository partitioning и worktree facets, появился в 3.0; hosted graph adapters и остальная roadmap — в планах. см. product 3.0 DoD и GraphRAG roadmap.

Установка

Требуется Node.js ≥ 22.22.

Пользователи

# npm (preferred)
npm install -g @innocarpe/carpeos
carpeos setup plan              # see paths + actions (no changes)
carpeos setup run --apply       # apply defaults

# or curl (installs the same package, then setup run --apply)
curl -fsSL https://raw.githubusercontent.com/innocarpe/carpeos/main/scripts/install.sh | bash

carpeos setup — это настоящий интерфейс CLI, а не разбор флагов. По умолчанию пути ведут в ~/.carpeos и ~/.local/bin; MCP регистрируется с Claude Code / Codex CLI / Grok Build, когда эти инструменты находятся в PATH.

carpeos setup --help            # full parameter interface
carpeos setup plan              # resolved plan only
carpeos setup run --apply       # apply the plan (home, wrappers, MCP)
carpeos setup hooks install --apply   # capture hooks (merge-safe; product path)
carpeos setup doctor            # verify install + hooks + store signals
carpeos setup show              # print config.json

Полезные опции: --home, --bin-dir, --workspace-root, --trust-zone, --register-mcp auto|none|claude,codex,grok, --register-hooks auto|none|…. Setup никак не изменяет машину без --apply.

Фиксируйте версию, когда важна воспроизводимость: npm i -g @innocarpe/carpeos@6.7.8. См. CHANGELOG.md. Milestone DoDs (для мейнтенеров): docs/maintainers/ · index продукта: docs/PRD.md.

Разработчики (git checkout)

git clone https://github.com/innocarpe/carpeos.git && cd carpeos
node scripts/install-local.mjs plan
node scripts/install-local.mjs run --apply   # build, wrappers, MCP registration
node scripts/install-local.mjs hooks install --apply
export PATH="$HOME/.local/bin:$PATH"
node scripts/install-local.mjs doctor

Для работы с монорепозиторием без глобальной установки: pnpm install && pnpm build, затем используйте node apps/carpeos-cli/dist/index.js … (см. локальный захват).

Путь продукта: установка → сессия → композиция → поиск

# 1) Runtime + MCP
carpeos setup run --apply
# 2) Capture hooks (Claude / Codex / Grok; merge-safe, does not wipe user hooks)
carpeos setup hooks install --apply
# 3) Always-on Agentic brain (30 minutes; network off by default)
carpeos agentic timer install
# 4) Doctor (hooks, store, adjudication health, promoted-only default search)
carpeos setup doctor
# 5) After a host session, meaning compounds without manual review:
#    capture → feed → agentic run (timer or:)
carpeos agentic run --once --materialize
carpeos retrieval rebuild --trust-zone tz_local_default
carpeos memory search \
  --query "durable decision" \
  --trust-zone tz_local_default \
  --visible-trust-zone tz_local_default

# Correction only (not the happy path)
# carpeos agentic retract --event-id evt_… --reason "…" --decided-by human --human-confirmed
# carpeos agentic promote-held --event-id evt_…
# carpeos adjudicate list-held --limit 50

# Kill / staging
# CARPEOS_AGENTIC=off …
# CARPEOS_AGENTIC_HOLD_FIRST=1 carpeos agentic run --once --materialize

carpeos setup doctor сообщает о статусе установки хуков, недавней активности EvidenceArtifact, количестве наблюдений и утверждений (Observation/Claim), версии политики арбитража и счётчиках promote/hold/reject, а также о том, что поиск по умолчанию работает только по подтверждённым (promoted) и активным записям (при пустом хранилище — предупреждение, а не ошибка).

Автоматические проверки:

Расширённые/ручные шаблоны хуков остаются в adapters/. Полные заметки: установка в один шаг · MCP · смоук-тест продукта.

Для агентов, работающих в этом репозитории

Сначала прочитайте AGENTS.md (граница public/private, метки PR, навык релиза, правила установки). Делайте установки идемпотентными; никогда не коммитьте ~/.carpeos, учётные данные или реальные данные сессий. Предпочитайте carpeos setup / scripts/install-local.mjs — не придумывайте альтернативные пути установки. Релизы: только SemVer + vX.Y.Z (версионирование, major release surface, skills/carpeos-release/SKILL.md).

Линейка продуктов (мажорные версии)

Текущий npm-пакет — @innocarpe/carpeos@6.7.8 (v6.7.8): цикл оператора через арбитраж и поиск, ортофактура доверия Product 4, опциональная черновая линия Product 5, и агентный слой Product 6 без HITL (мозг Flash после захвата; promote-when-verified, отзыв, удержание, 30-минутный таймер — ADR 0018) плюс агентная плоскость качества (6.7.x: подготовленные пакеты, преследование, построчный приём, восстановление утверждений, связь с источниками, DoD корпуса качества, предотвращение дублирования, более плотные адаптеры хостов — захват остаётся «простым»; эвристич- ино- средства для человека — только для исправления). Полный индекс мажоров, миноров и DoD:

• docs/PRD.md — один PRD на мажор

• docs/architecture/agentic-layer.md — карта сервисов

• docs/architecture/agentic-quality.md — цель качества в рамках agentic-слоя

• docs/maintainers/ — отчёты product-N.0.0.md (например, 6.0.0, 5.0.0)

Честные остатки (без приукрашиваний): Product 4 live-авторизация релизов вне очереди; отложено применение B1; хостируемый граф/edge не заявляется; V5 не попадает на «горячий путь» захвата; автоматическое продвижение по-прежнему смещено в сторону удержания; использование Flash в продукте остаётся в режиме opt-in; Q-S5 dogfood остаётся рекомендательной проверкой (поставлен вспомогательный инструмент метрик).

Что уже работает

Публичный пакет: @innocarpe/carpeos@6.7.8 (v6.7.8 · CHANGELOG). Установка через npm не означает размещённый деплой или живую авторизацию релизов Product 4.

Локальный контур по умолчанию (проверяется CI):

hooks → encrypted evidence → agentic_capture_feed (no LLM in capture)
  → agentic flush / run / 30m timer (promote-when-verified, agentic_v1.1)
  → quality belt (line-scoped admit, scrubbed pack views, cite clamp, near-dup)
  → active Observations in default search
  → retrieval-first graph/hybrid recall → MCP / CLI
  (+ adj_v3 baseline, local OKF export, optional private sync, Obsidian)

# Kill: CARPEOS_AGENTIC=off
# Staging: CARPEOS_AGENTIC_HOLD_FIRST=1
# Offline (no Flash): CARPEOS_AGENTIC_NETWORK=off or --allow-network false
# Credentials: DEEPSEEK_API_KEY or ~/.carpeos/v5-provider.env
# Q-S5 advisory: node scripts/quality-qs5-metrics.mjs --days 7

НЕ РАЗВЁРНУТО: ни хостинговый Worker, ни продакшн-ресурсы D1/R2, ни хостингуемые граф-адаптеры/сервисы, ни внедрение приватного vault, ни хостинг MCP не подтверждены этим репозиторием. npm publish ограничен SemVer-тегами и CI (версионирование).

Не считайте установку адаптера, живую настройку Cloudflare, хостинг MCP или калиброванную человеческую оценку завершёнными, пока этот репозиторий не подтвердит это тестами и документацией.

Границы репозитория

Только публичная реализация. Runtime-знания остаются приватными.

Влияние на дизайн

Некоторые идеи пересекаются с obsidian-mind (память агента, хуки, retrieval для агентов). CarpeOS — это отдельный дизайн: append-only события вместо Markdown-хранилища как источника истины, явный claim/acceptance/supersession, зоны доверия, защищённые значения и MCP, не привязанный к одному вендору.

Участие в разработке

См. CONTRIBUTING.md, GOVERNANCE.md и AGENTS.md.

pnpm check   # format, lint, build, typecheck, test, public-boundary

Публичные релизы пакетов используют один общий процесс (любой кодирующий агент должен следовать этому навыку):

./scripts/install-release-skill.sh   # Claude / Codex / Grok skill links
# then: release / tag / npm — see skills/carpeos-release/SKILL.md

Лицензия

Apache License 2.0