This directory contains Go-specific documents for the codex-mem implementation.
These docs are now physically grouped by audience, not just linked that way from a flat index.
- user/ End-user usage guidance, memory concepts, and prompt examples.
- operator/ Client registration, deployment/readiness, and troubleshooting.
- maintainer/ Source-tree integration, implementation planning, and development tracking.
If you are using codex-mem day to day:
If you are deploying or operating the MCP server:
- Client Examples
- Import Ingestion Batch import, long-lived follow mode, cleanup/audit hygiene commands, and packaged example-catalog lookup.
- V2 Embedding Backfill And Health Draft Draft operator workflow for semantic backfill, health checks, and rebuild-oriented recovery.
- Release Readiness
- Troubleshooting
If you are maintaining or testing the Go implementation:
- MCP Integration Stdio/HTTP transport behavior, current 11-tool MCP surface, and source-tree smoke tests.
- Development Tracker
- Development Kickoff
- Implementation Plan
- V2 Hybrid Retrieval Roadmap Early maintainer draft for possible v2 retrieval evolution.
- V2 Semantic Interfaces Draft Draft package-level interfaces for embedding providers, semantic indexes, and hybrid retrieval wiring.
- Spec V2 Runtime Resurfacing Draft Draft runtime algorithm and working-context shaping for implicit memory resurfacing.
- Spec V2 Embedding Storage Draft Draft storage and backfill design for local-first semantic retrieval.
- Spec V2 Conformance Scenarios Draft Draft scenario matrix for proving lexical fallback, policy guardrails, and bounded resurfacing behavior.
- Spec V2 Migration Sequencing Draft Draft rollout order for additive schema changes, sidecar bootstrap, and config-gated hybrid enablement.
Go planning now lives under maintainer/:
Normative product specification remains here: