One local memory, many agents.

Agent Installers

Use the installer for the agent you use most. Installers create or update ~/link, install link-mcp, write short agent instructions, and preserve existing wiki data.

bash integrations/codex/install.sh
bash integrations/kiro/install.sh
bash integrations/claude-code/install.sh
bash integrations/cursor/install.sh
bash integrations/copilot/install.sh
bash integrations/vscode/install.sh
bash integrations/antigravity/install.sh

Use --project from a repo when memory should be project-scoped.

MCP Only

python3 -m pip install --upgrade link-mcp

{
  "mcpServers": {
    "link": {
      "command": "python3",
      "args": ["-m", "link_mcp", "--wiki", "~/link/wiki"]
    }
  }
}

On macOS/Homebrew Python, if pip reports externally-managed-environment, use a dedicated venv:

python3 -m venv ~/.link-mcp-venv
~/.link-mcp-venv/bin/python -m pip install --upgrade pip link-mcp

{
  "mcpServers": {
    "link": {
      "command": "/Users/YOU/.link-mcp-venv/bin/python",
      "args": ["-m", "link_mcp", "--wiki", "/Users/YOU/link/wiki"]
    }
  }
}

Predictable Agent Workflow

Agents should use Link in this order:

1. Call link_status when connecting or troubleshooting.
2. Call starter_prompts when the user asks what to try next.
3. Call ingest_status before ingesting raw files.
4. Call query_link first for most answers.
5. Call memory_brief before longer work.
6. Call get_graph_summary when graph context is needed.
7. Call backup_wiki before broad repair work.
8. Call validate_wiki after ingest or substantial page edits.

MCP Tools

Full tool set:

link_status
starter_prompts
migrate_wiki
ingest_status
query_link
validate_wiki
backup_wiki
memory_brief
memory_audit
memory_profile
memory_inbox
review_memory
explain_memory
search_wiki
recall_memory
remember_memory
propose_memories
capture_session
capture_inbox
accept_capture
redact_capture
delete_capture
update_memory
archive_memory
restore_memory
forget_memory
get_context
get_pages
get_backlinks
get_graph_summary
get_graph
rebuild_index
rebuild_backlinks

Memory write tools return duplicate_candidates or conflict_candidates when review, update, or archive is safer than creating another memory page.

Project-aware tools accept an optional project argument. When set, Link returns broad user/global memory plus memories for that project, while excluding memories from other explicit projects.

Verify Setup

link verify-mcp
link status --validate
link prompts

link verify-mcp --json is useful when an agent or script should read structured issues and next actions.