CarpeOS

English · 한국어

Kontext erfassen. Wissen verdichten.

CarpeOS ist ein persönliches Wissens-Betriebssystem für KI-gestützte Arbeit. Es erfasst Agent-Sitzungen mit Herkunftsnachweis, bildet dauerhafte Bedeutung zum Zeitpunkt des Schreibens (günstige adj_v3-Regeln plus eine Agentic Layer nach der Erfassung), hält geförderte Entscheidungen standardmäßig durchsuchbar und hilft dir und deinen Agenten, diesen Kontext später über MCP, CLI und Obsidian abzurufen – alles lokal-first, ohne erforderliche menschliche Prüfung auf dem Happy Path.

Es bewahrt die Spur, woher jedes Stück stammt, ohne jeden Sitzungsdump in „Erinnerung“ zu verwandeln.

Aktuelles Paket: @innocarpe/carpeos@6.7.8 (CHANGELOG · v6.7.8).

Website

Besuche die CarpeOS-Website für die Produktübersicht, das Systemmodell, den Installationspfad und den öffentlichen Dokumentationsleitfaden.

Related MCP server: memory_plus

Warum es das gibt

Du beendest eine lange Agent-Sitzung mit einer echten Entscheidung, einem halbfertigen Plan oder einem Bug-Pfad, den du nicht noch einmal entdecken willst. Eine Woche später ist dieser Kontext über Chat-Verlauf, Terminal-Scrollback und ein paar Notizen verstreut – und der nächste Agent hat nichts davon.

CarpeOS ist der Versuch, diesen Kontext an einem Ort zu halten, den du kontrollierst, mit genug Struktur, dass „wir haben X entschieden“ nicht genauso behandelt wird wie „das Modell hat einmal X vorgeschlagen“.

Öffentlicher Code. Privates Wissen.
Dieses Repo enthält Design, Spezifikationen und Implementierung. Deine echten Sitzungen, Projekte und Anmeldedaten bleiben auf deiner Seite.

Für wen es gedacht ist

Nützlich, wenn du:

• Zwischen Agenten wechselst (Codex, Claude Code, Grok Build, …) und keine separate Memory-Geschichte für jeden haben willst

• Die Entscheidungen der letzten Woche noch verfügbar brauchst, nicht in einem alten Transkript vergraben

• Beim Suchen wissen willst, ob etwas ein Entwurf, abgelehnt oder tatsächlich akzeptiert ist

• Daten standardmäßig lokal willst, mit Synchronisation, die du selbst ausführst, wenn du sie brauchst

• Explizite Schemata und Tests einem Black-Box-„Memory-Produkt“ vorziehst

Noch keine ausgereifte Consumer-App. Kein gehostetes SaaS. Kein Ersatz für deinen Editor. Eher Infrastruktur für Leute, die bereits in Agent-Workflows leben.

Was in der Box ist

Erfassung aus Tools, die du bereits nutzt

Hooks bilden ausgewählte Lebenszyklus-Ereignisse von Codex, Claude Code und Grok Build in eine gemeinsame Erfassungsform ab. Rohe Payloads liegen in verschlüsseltem Speicher; das Ereignisprotokoll hält Metadaten und Referenzen. Host-Hooks bleiben fail-open und schnell.

Bedeutung vor „Memory“ formen (zwei Ebenen)

Nach der Erfassung können zwei Schreibzeit-Pfade zuweisen, was es wert ist, behalten zu werden:

Agentic (ADR 0018): verifizierte Allowlist-Extrakte (decision / constraint / preference) fördern standardmäßig, wenn E5 die Aussage in zitierten Spannen verankert – kein menschlicher Klick nötig. procedure und fact_candidate bleiben hold-basiert. Menschen ziehen Fehler zurück, akzeptieren optional accept-claim oder räumen Holds auf – nur Korrektur.

Die Hold-Überprüfung bleibt policy-bewusst und append-only für beide Ebenen. Keiner der Pfade erstellt automatisch eine AcceptanceDecision.

adj_v3-Fundament (3.2+) und B0-Policy-Abgleich-Vorschau bleiben verfügbar:

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

B0 ist nur Metadaten und unterstützt nur diese exakten Flags: --from-policy, --to-policy, --trust-zone und --limit. --apply, --apply-safe-subset, Bestätigungen, Quittungen und Supersession-Konstruktion werden nicht unterstützt. B1-Schreib-/Anwendungs-/Quittungsarbeit bleibt aufgeschoben. Dogfood-Eingaben und -Ausgaben sind synthetisch und wegwerfbar.

Ein Modell, das Status nicht einebnet

Beleg ist keine Behauptung. Eine Behauptung ist nicht „wahr“, nur weil sie existiert. Akzeptanz und Supersession sind eigene Datensätze. Die Suche kann zeigen, was geklärt ist, was nur vorgeschlagen ist und was ersetzt wurde – ohne alles in einen Absatz Vektor-Text zu packen.

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

Schnittstellen für Menschen und Agenten

• CLI — capture-hook, extract, adjudicate, agentic (run / timer / retract / golden / graphrag…), retrieval rebuild, memory search|get|context-pack (Standard nur gefördert; --include-held opt-in), sync status|push|pull|once|cycle

• MCP (stdio) — acht lokale Tools (memory_search, memory_get, memory_context_pack, memory_trace, memory_timeline, memory_related, memory_capture, memory_propose_claim)

• Immer an Agentic — optionaler 30-Minuten-Timer: carpeos agentic timer install (Netzwerk standardmäßig aus)

• Obsidian-Projektion — Markdown-Dateien, die aus dem lokalen Store generiert werden (nur Projektion; nicht die Quelle der Wahrheit)

• OKF-v0.2-Export-Projektion — carpeos okf export|rebuild schreibt ein trust-zone-begrenztes, standardmäßig gefördertes/aktives portables Bündel; es ist kein kanonischer Speicher oder Importpfad (Guide)

Lokal zuerst, Synchronisation optional

Jede Maschine schreibt in ein lokales Outbox. Es gibt bereitstellbaren Cloudflare Worker/D1/R2-Code, wenn du private Multi-Geräte-Synchronisation willst, plus einen begrenzten carpeos sync cycle für Operator-Schleifen. Projektionen können jederzeit aus dem Ereignisprotokoll neu aufgebaut werden.

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

Wie es zusammenpasst

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

Regeln, die man vorab kennen sollte:

1. Das Ereignisprotokoll ist append-only; Dispositionen sind append-only nach Richtlinienversion.

2. Standardsuche ist geförderte/aktive Bedeutung – nicht jede erfasste Sitzung.

3. Agentic fördert bei Verifizierung und schließt die Schleife ohne last-tragendes HITL (ADR 0018); formale AcceptanceDecision bleibt menschen-only und optional.

4. „Akzeptiert“ wird zur Abfragezeit berechnet – wir schreiben eine Behauptung nicht an Ort und Stelle um.

5. Sensibler Klartext wird nicht im Ereignisbody gespeichert.

6. Trust-Zonen sind echte Isolationsgrenzen, keine Etiketten für die Show.

7. Notizen, Vektoren und Kontext-Pakete können gelöscht und neu aufgebaut werden; sie sind nicht der kanonische Store.

Mehr Details: Architekturübersicht, Agentic Layer, Memory-Kapazität, ADR 0017, ADR 0018, ADRs, spec/v1.

Memory-Kapazität (gesamt vs. aktiv)

CarpeOS trennt wie viel privates Wissen du speicherst von wie viel ein Agent gerade lädt:

Kontext-Pakete nutzen spärliche Expert-Slot-Zuweisung (Standard 16 Slots) und eine cache-freundliche Abschnittsreihenfolge, sodass akzeptierte Fakten vor hochfrequenten Entwürfen bleiben. Siehe die Memory-Kapazitäts-Architekturnotiz und den Kapazitäts-Masterplan. Retrieval-first-Graph-/Hybrid-Abruf – einschließlich Cross-Repository-Partitionierung und Worktree-Facetten – wurde in 3.0 ausgeliefert; gehostete Graph-Adapter und andere Roadmap-Arbeit bleiben geplant. Siehe die Produkt-3.0-DoD und GraphRAG-Roadmap.

Installation

Erfordert Node.js ≥ 22.22.

Benutzer

# 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 ist eine echte CLI-Oberfläche – kein Flag-Dump. Standardpfade landen unter ~/.carpeos und ~/.local/bin; MCP registriert sich bei Claude Code / Codex CLI / Grok Build, wenn diese Tools auf PATH sind.

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

Nützliche Optionen: --home, --bin-dir, --workspace-root, --trust-zone, --register-mcp auto|none|claude,codex,grok, --register-hooks auto|none|…. Setup mutiert die Maschine nie ohne --apply.

Pinne eine Version, wenn dir Reproduzierbarkeit wichtig ist: npm i -g @innocarpe/carpeos@6.7.8. Siehe CHANGELOG.md. Meilenstein-DoDs (Maintainer): docs/maintainers/ · Produktindex: docs/PRD.md.

Entwickler (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

Für Monorepo-Arbeit ohne globale Installation: pnpm install && pnpm build ausführen, dann node apps/carpeos-cli/dist/index.js … verwenden (siehe lokale Erfassung).

Produktpfad: Installation → Session → Erfassung → Suche

# 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 meldet den Installationsstatus der Hooks, aktuelle EvidenceArtifact-Aktivität, Observation/Claim-Zählungen sowie die Adjudication-Policy-Version inklusive promote/hold/reject-Zählern und dass die Standardsuche nur nach promoted/active durchsucht (leerer Store → Warnungen, kein Fehler).

Automatisierte Gates:

Erweiterte/manuelle Hook-Vorlagen bleiben unter adapters/. Ausführliche Hinweise: One-Stop-Installation · MCP · Produkt-Smoke-Test.

Für Agenten, die in diesem Repo arbeiten

Zuerst AGENTS.md lesen (öffentlich/privat-Grenze, PR-Labels, Release-Skill, Installationsregeln). Installationen idempotent halten; niemals ~/.carpeos, Zugangsdaten oder echte Session-Daten committen. Bevorzugt carpeos setup bzw. scripts/install-local.mjs – keine alternativen Installationspfade erfinden. Releases: ausschließlich SemVer + vX.Y.Z (Versionierung, Major-Release-Oberfläche, skills/carpeos-release/SKILL.md).

Produktlinie (Majors)

Das aktuelle npm-Package ist @innocarpe/carpeos@6.7.8 (v6.7.8): Operator-Loop durch Adjudication und Retrieval, Product-4-Trust-Ebene, optionale Product-5-Entwurfsspur und Product 6 HITL-free Agentic-Schicht (Post-Capture-Flash-Gehirn; promote-when-verified; Zurückziehen; Tagesbudget; 30-Minuten-Timer – ADR 0018) plus der agentic-Qualitätsebene (6.7.x: vorbereitete Packs, Schwärzung, wiederauffindung, Zusagen, jeweils auf Zeichen; Zeichen, Transkript-Wiederherstellung, Zitier-Grounding, Qualitätskorpus-DoD, Near-Duplicate-Hold, dichtere Host-Adapter – die Erfassung bleibt passiv; menschliche Werkzeuge sind nur zur Korrektur).

Umfassender Major-/Minor-Thesis- und DoD-Index:

• docs/PRD.md – ein PRD pro Major

• docs/architecture/agentic-layer.md – Servicekarte

• docs/architecture/agentic-quality.md – Qualitäts-Ultraergoal

• docs/maintainers/ – product-N.0.0.md-Belege (z. B. 6.0.0, 5.0.0)

Ehrliche Restpunkte (kein „Grün“ erfinden): Live-Product-4-Release-Autorität gehört nicht dazu; B1-Apply ist aufgeschoben; andere/gehostete Graphen/Edges sind nicht releases; V5 läuft nie auf dem Capture-Hot-Path; Prozedurales Auto-Promote bleibt haltbehindert; Live-Flash bleibt ein Opt-in-Netzwerk; Q-S5-Dogfood bleibt rein beratend (Metrik-Helfer wird mitgeliefert).

Was heute funktioniert

Öffentliches npm-Paket: @innocarpe/carpeos/@6.7.8 (v6.7.8 · CHANGELOG). npm install bedeutet kein Hosted Deployment oder eine Live-Product-4-Freigabe-Autorität.

Standardrry lokal Loop (CI-geprüft):

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

NICHT BEREITGESTELLT: Von diesem Repository werden weder gehostete Worker, D1/R2-Produktionsressourcen, gehostete Graph-Adapter/-Dienste, Private-Vault-Übernahme noch gehostetes MCP nachgewiesen. npm publish ist an SemVer-Tags + CI gebunden (Versionierung).

Behandeln Sie die Adapter-Installation, ein Live-Cloudflare-Setup, gehostetes MCP oder kalibriertes menschliches Urteilsvermögen nicht als abgeschlossen, bis dieses Repository dies mit Tests und Dokumenten bestätigt.

Repo-Grenze

Nur öffentliche Implementierung. Laufzeitwissen bleibt privat.

Design-Einflüsse

Einige Ideen überschneiden sich mit obsidian-mind (Agent-Speicher, Hooks, Retrieval für Agents). CarpeOS ist ein separates Design: Append-only-Ereignisse statt eines Markdown-Vaults als Autorität, explizites Claim/Acceptance/Supersession, Vertrauenszonen, geschützte Werte und MCP, das nicht an einen Anbieter gebunden ist.

Mitwirken

Siehe CONTRIBUTING.md, GOVERNANCE.md und AGENTS.md.

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

Öffentliche Paketveröffentlichungen verwenden einen gemeinsamen Prozess (jeder Coding-Agent sollte denselben Skill befolgen):

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

Lizenz

Apache License 2.0