README.md

Developer Documentation

This section is for developers working on Memory Layer itself: architecture, internal workflows, packaging, plans, and skill-facing material.

Table of Contents

• Quickstart
• Architecture
• Implementation Material
• Related Docs

Quickstart

Run a fully isolated dev copy of Memory Layer alongside any packaged install on the same machine:

cargo run --bin memory -- init
cargo run --bin memory -- dev init --copy-from-global
cargo run --bin memory -- service run            # 4250 HTTP, 4251 capnp
cargo run --bin memory -- tui                    # header reads [dev]

The dev stack is detected automatically when the binary path lives under target/{debug,release}/ and reads its config from .mem/config.toml plus a .mem/config.dev.toml overlay — never from the installed global config.

For the full isolation contract, default ports, override flags, and troubleshooting, see Dev Stack vs Installed Stack.

Architecture

• Dev Stack vs Installed Stack
• Architecture Overview
• Memory Types Reference
• How Memory Layer Works
• Embeddings and Search
• Hidden Memory Daemon
• Automated Evaluation
• Memory Improvement Benchmark

Implementation Material

• Implementation Plans
• Skills And Agent Material
• How Skills Work
• Examples

Related Docs

• User Documentation
• Project README