How usememos/memos works
Memos is a self-hosted, Markdown-first notes timeline: users create memos, add files, find and revisit them, and choose whether to keep them private or share them. The runtime includes a web client, an HTTP/API server, authentication, memo and attachment handling, persistent storage, and optional integrations. The README documents search, tags, reusable views, timeline browsing, and full export; these are represented as product capabilities, but their internal call paths are not inferred from the sampled files. Edges are limited to relationships visible in the excerpts or README.
Main entry points: server.go HTTP server · storage.go Attachment storage · auth_service_session.go Authentication API · index.tsx Memo editor
Components 25
Web client
- Web application
web/src/App.tsx - Memo editor
web/src/components/MemoEditor/index.tsx - Markdown rendering
web/src/components/MemoContent/pipeline.ts - Timeline and search
web/src/components/PagedMemoList/PagedMemoList.tsx - Calendar browsing
web/src/components/CalendarView/CalendarView.tsx - Storage settings
web/src/components/Settings/StorageSection.tsx
HTTP and API
- HTTP server
server/server.go - Connect handlers
proto/gen/api/v1/apiv1connect/memo_service.connect.go - Authentication API
server/api/v1/auth_service_session.go - Memo API
server/api/v1/memo_service_query.go - Attachment API
server/api/v1/attachment_service_storage.go - MCP endpoint
server/mcp/service.go
Memo features
- Memo lifecycle
server/api/v1/memo_service.go - Visibility and sharing
server/api/v1/memo_share_service.go - Memo export
core/memoexport/writer.go - Token authentication
server/auth/authenticator.go - Attachment transfer
server/api/v1/attachment_service_storage.go
Persistence
- Store interfaces
store/store.go - Database drivers
store/db/sqlite/sqlite.go - Attachment storage
store/storage.go
Integrations
- S3 provider
provider/storage/s3/s3.go - Email notifications
core/notification/email.go - AI providers
provider/ai/resolver.go - Identity providers
provider/idp/idp.go
Other components
- User
Connections 16
- User → Web application: uses
README.md - HTTP server → Web application: serves
server/server.go - HTTP server → Attachment API: registers routes
server/server.go - HTTP server → Memo API: registers gateway
server/server.go - Attachment API → Attachment storage: resolves storage
server/api/v1/attachment_service_storage.go - Attachment storage → S3 provider: uses driver
store/storage.go - Authentication API → Token authentication: authenticates refresh
server/api/v1/auth_service_session.go - Authentication API → Store interfaces: updates tokens
server/api/v1/auth_service_session.go - Memo API → Store interfaces: builds query
server/api/v1/memo_service_query.go - User → Memo editor: writes Markdown
README.md - User → Timeline and search: finds memos
README.md - User → Calendar browsing: browses timeline
README.md - User → Visibility and sharing: chooses visibility
README.md - User → Memo export: exports memos
README.md - Memo editor → Markdown rendering: renders Markdown
- Storage settings → Attachment storage: configures storage