SoraMemo Architecture Overview

Welcome to the SoraMemo Knowledge Base. This portal documents the local-first storage format, deterministic CRDT merge protocol, and CLI automation tools.

1. Workspace Directory Layout

Each SoraMemo vault is stored as standard UTF-8 Markdown files accompanied by a compact SQLite WAL index:

workspace/
├── .soramemo/
│   ├── config.toml
│   └── state.idx
├── daily/
│   └── 2026-10-26.md
└── projects/
    └── architecture-notes.md

2. CLI Quickstart

Initialize and synchronize a local vault from the terminal:

$ soramemo init ~/Notes
$ soramemo sync --verify-signatures