- "We use Drizzle not Prisma. pnpm not npm. No default exports."
- (repeated every session, by every developer, forever)
+ edgemem write "memory/stack.md" "..."   # once
+ # Claude knows. Every session. Every developer.

Team writes conventions once → stored in Supermemory cloud
                                        ↓
Every Claude Code session → edgemem loads what's relevant
                                        ↓
Agent learns something new → edgemem saves it automatically
                                        ↓
Next session → Claude already knows

export SUPERMEMORY_API_KEY=sm-...
export EDGEMEM_CONTAINER=myproject-team

npx edgemem init          # setup project, update CLAUDE.md
npx edgemem write "memory/stack.md" "
Database: PostgreSQL 16
ORM: Drizzle (not Prisma)
Package manager: pnpm
Framework: Next.js App Router
"
npx edgemem sync          # pull memory → .claude/memory/
claude                    # open Claude Code — it reads memory automatically

{
  "mcpServers": {
    "edgemem": {
      "command": "npx",
      "args": ["@edgemem/mcp"],
      "env": {
        "SUPERMEMORY_API_KEY": "${SUPERMEMORY_API_KEY}",
        "EDGEMEM_CONTAINER": "myproject-team"
      }
    }
  }
}

cp -r examples/phase3-hook/.claude .claude
export EDGEMEM_CONTAINER=myproject-team

# CLI — use the --force flag
npx edgemem write "memory/stack.md" "updated stack" --force

# MCP server — set the env var
EDGEMEM_ALLOW_CORE_MUTATION=true npx @edgemem/mcp

{"timestamp":"2026-06-08T10:33:10Z","action":"read","file_path":"memory/stack.md","status":"ok"}
{"timestamp":"2026-06-08T10:33:11Z","action":"write","file_path":"memory/auto-saved.md","status":"pii-redacted","detail":"redacted: stripe-live-key"}
{"timestamp":"2026-06-08T10:33:12Z","action":"read","file_path":"memory/stack.md","status":"cache-hit"}

[edgemem] Showing 3/8 sections (~2,400 tokens). Remaining omitted to protect context window.

## Database
PostgreSQL 16 with Drizzle ORM.

## Migrations
Run with pnpm db:migrate. Never edit migrations by hand.

# Setup
npx edgemem init [--container <name>] [--api-key-env <name>]

# Sync (Phase 1)
npx edgemem sync [--output <dir>] [--container <name>]

# Read / write
npx edgemem read <path> [--container <name>]
npx edgemem write <path> <content> [--container <name>] [--force]
npx edgemem append <path> <content> [--container <name>] [--force]

# Search
npx edgemem grep <query> [--path <path>] [--container <name>]
npx edgemem list [--path <path>] [--container <name>]

# Hook injection (Phase 3)
npx edgemem inject [--container <name>] [--format context|json]

# Developer A (Monday)
npx edgemem append "memory/conventions.md" "Use server actions for mutations" --force

# Developer B (Tuesday, different machine)
claude
# → Claude already knows about server actions. No sync needed. No commit needed.

git clone your-repo
export SUPERMEMORY_API_KEY=sm-...   # from team 1Password
claude
# → Claude knows the entire project context from day one

memory/stack.md        — tech stack, versions, tools              [protected]
memory/conventions.md  — coding conventions and patterns          [protected]
memory/decisions.md    — architecture decisions and rationale     [protected]
memory/onboarding.md   — guide for new developers                 [protected]
memory/auto-saved.md   — conventions captured automatically        [writable]
memory/<anything>.md   — your own files                            [writable]

<!-- edgemem: 2026-06-08T10:33:10.123Z | session: a3f9b2c1 -->

# CLAUDE.md — structural rules (static)

Project layout, tool configuration, things that almost never change.

# Dynamic memory — managed by edgemem

@.claude/memory/conventions.md
@.claude/memory/decisions.md

{
  "container": "myproject-team",
  "apiKeyEnv": "SUPERMEMORY_API_KEY"
}

{
  "container": "myproject-team",
  "apiKey": "sm-..."
}

pnpm install
pnpm build      # compile all packages
pnpm test       # run all 167 tests

packages/
  core/          @edgemem/core — MemClient, guard, cache, audit, chunker
  mcp/           @edgemem/mcp  — MCP server (5 tools)
  cli/           edgemem       — CLI (init, sync, read, write, append, grep, list, inject)
examples/
  phase1-claudemd/  — file sync example + setup.sh
  phase2-mcp/       — .mcp.json + CLAUDE.md instructions
  phase3-hook/      — .claude/settings.json + auto-save.sh