How gowtham0992/link works
Link is a local, Markdown-backed memory layer for AI agents. Users capture source material, structure it into a source-backed wiki, review proposed durable memories, then retrieve compact context through CLI, MCP, or the local viewer. The graph includes those domain stages, security and filesystem foundations, and the macOS LinkBar client. Several capability branches are documented but their implementations were not sampled; those are represented at directory level, and only documented or indexed relationships are connected.
Main entry points: memory.py Memory governance · link.py CLI · query.py Query packets · capture.py Capture proposals
Components 23
Agent interfaces
- CLI
link.py - MCP server
mcp_package/link_mcp/server.py - Local viewer
serve.py - Session hooks
mcp_package/link_core/agent_hooks.py - Viewer features
mcp_package/link_core
Capture and structure
- Capture proposals
mcp_package/link_core/capture.py - Raw ingestion
mcp_package/link_core/ingest.py - Structured import
mcp_package/link_core/structured_ingest.py - Memory importers
mcp_package/link_core/importers.py - Safety checks
mcp_package/link_core/security.py
Memory and retrieval
- Memory governance
mcp_package/link_core/memory.py - Query packets
mcp_package/link_core/query.py - Wiki indexing
mcp_package/link_core/wiki.py - Semantic retrieval
mcp_package/link_core/semantic.py - Memory consolidation
mcp_package/link_core/consolidate.py
Local workspace
- Raw sources
- Markdown wiki
- Atomic file access
mcp_package/link_core/files.py - Activity log
mcp_package/link_core/log.py
Desktop client
- LinkBar app
apps/LinkBar/Sources/LinkBar/LinkStore.swift - CLI bridge
apps/LinkBar/Sources/LinkBar/LinkCLI.swift
Other components
- User
- Local agents
Connections 34
- User → CLI: runs commands
README.md - Local agents → MCP server: query memory
README.md - Local agents → CLI: retrieve context
README.md - User → Local viewer: opens viewer
README.md - User → LinkBar app: reviews memory
README.md - CLI → Capture proposals: captures proposals
link.py - CLI → Memory governance: manages memories
link.py - CLI → Query packets: builds packets
link.py - CLI → Raw ingestion: checks ingest
link.py - MCP server → Memory governance: calls memory logic
mcp_package/link_mcp/server.py - MCP server → Capture proposals: handles capture
mcp_package/link_mcp/server.py - Local viewer → Query packets: serves retrieval
serve.py - Local viewer → Viewer features: serves pages
serve.py - Session hooks → Capture proposals: proposes captures
- Capture proposals → Safety checks: checks content
mcp_package/link_core/capture.py - Capture proposals → Atomic file access: writes proposals
mcp_package/link_core/capture.py - Raw sources → Raw ingestion: ingested from
README.md - Raw ingestion → Safety checks: scans sources
mcp_package/link_core/ingest.py - Raw ingestion → Wiki indexing: structures pages
mcp_package/link_core/ingest.py - Structured import → Atomic file access: writes pages
mcp_package/link_core/structured_ingest.py - Memory importers → Memory governance: imports memory
- Memory governance → Safety checks: checks memory
mcp_package/link_core/memory.py - Memory governance → Atomic file access: persists memory
mcp_package/link_core/memory.py - Memory governance → Memory consolidation: delegates consolidation
mcp_package/link_core/memory.py - Memory governance → Semantic retrieval: uses retrieval
mcp_package/link_core/memory.py - Query packets → Memory governance: recalls memories
mcp_package/link_core/query.py - Query packets → Wiki indexing: retrieves pages
mcp_package/link_core/query.py - Query packets → Semantic retrieval: ranks semantically
mcp_package/link_core/query.py - Wiki indexing → Atomic file access: reads workspace
mcp_package/link_core/wiki.py - Wiki indexing → Markdown wiki: indexes pages
README.md - Semantic retrieval → Atomic file access: reads local index
mcp_package/link_core/semantic.py - LinkBar app → CLI bridge: requests CLI data
apps/LinkBar/Sources/LinkBar/LinkStore.swift - CLI bridge → CLI: runs commands
- Markdown wiki → User: inspected directly
README.md