How memrohq/memro works
Memro is a shared memory and rules service for AI coding agents. Its local-first workflow captures durable rules into a repository and installs agent hooks so they are surfaced and checked during sessions; connecting adds shared memory, search, coordination, and integrations through the API. Agents can access the service through MCP, SDKs, and CLI-configured clients, while users manage memories and integrations in the dashboard. The server also ingests external sources and provides memory search and graph capabilities. Several subsystem links below are documented rather than source-verified; those use the README as evidence.
Main entry points: server.go HTTP API · App.jsx Dashboard shell · server.py MCP server · engine.go Memory engine
Components 29
Agent access
- CLI commands
cli/src/cli.js - Client setup
cli/src/clients.js - Agent hooks
cli/src/hook.js - MCP tools
mcp/src/memro_mcp/supermemory_tools.py - MCP server
mcp/src/memro_mcp/server.py - Python SDK
sdk/python/src/memro/client.py - JavaScript SDK
sdk/js/src/client.ts - Go SDK
sdk/go/client.go
Memory service
- HTTP API
server/internal/api/server.go - Memory handlers
server/internal/api/handlers_engine.go - Memory engine
server/internal/engine/engine.go - Persistence
server/internal/store/store.go - PostgreSQL
- Embeddings
server/internal/embed/embed.go - Memory indexing
server/internal/indexer/indexer.go
Dashboard
- Dashboard shell
apps/dashboard/src/App.jsx - Dashboard API client
apps/dashboard/src/lib/api.js - Memory views
apps/dashboard/src/views/Memories.jsx - Search view
apps/dashboard/src/views/Search.jsx - Memory graph
apps/dashboard/src/views/Graph.jsx - Admin console
apps/dashboard/src/views/Admin.jsx - Connect view
apps/dashboard/src/views/Connect.jsx
Integrations
- Connector ingestion
server/internal/connectors/ingest.go - Connector providers
server/internal/connectors/catalog.go - Claude session hook
integrations/claude-code/hooks/session-start.mjs - VS Code integration
integrations/vscode/src/extension.ts - Acode integration
integrations/acode/index.js
Other components
- Developer
- AI agent
Connections 32
- Developer → CLI commands: configures
README.md - CLI commands → Client setup: dispatches setup
cli/src/cli.js - Client setup → Agent hooks: installs hooks
cli/src/clients.js - AI agent → Agent hooks: starts session
README.md - AI agent → MCP server: uses tools
README.md - MCP server → MCP tools: registers tools
mcp/src/memro_mcp/server.py - MCP server → HTTP API: calls API
README.md - Python SDK → HTTP API: calls API
README.md - JavaScript SDK → HTTP API: calls API
README.md - Go SDK → HTTP API: calls API
README.md - HTTP API → Memory handlers: routes requests
server/internal/api/server.go - Memory handlers → Memory engine: searches memories
server/internal/api/handlers_engine.go - Memory engine → PostgreSQL: queries memory data
README.md - Memory engine → Embeddings: creates embeddings
- Memory indexing → Memory engine: invalidates cache
- Memory indexing → Persistence: indexes memories
- Persistence → PostgreSQL: persists records
README.md - Developer → Dashboard shell: manages memory
README.md - Dashboard shell → Dashboard API client: loads data
apps/dashboard/src/App.jsx - Dashboard API client → HTTP API: sends HTTP requests
apps/dashboard/src/lib/api.js - Dashboard shell → Memory views: renders view
apps/dashboard/src/App.jsx - Dashboard shell → Search view: renders view
apps/dashboard/src/App.jsx - Dashboard shell → Memory graph: renders view
apps/dashboard/src/App.jsx - Dashboard shell → Admin console: renders console
apps/dashboard/src/App.jsx - Dashboard shell → Connect view: renders view
apps/dashboard/src/App.jsx - HTTP API → Connector providers: configures connectors
- Connector providers → Connector ingestion: dispatches ingestion
- Connector ingestion → Persistence: writes memories
- Connector ingestion → Memory indexing: invalidates index
- Claude session hook → MCP server: connects session
- VS Code integration → HTTP API: uses service
- Acode integration → HTTP API: uses service