Connect an agent
Use the installer with selected channels, server URL, and API token.
The installer can configure selected channels:
Installer path
Shell
Use --base-url when the server is already running:
Shell
Shared connection settings live in ~/.lore/config.json; plugin-specific config can override them, while legacy environment variables are only fallbacks:
| Value | Meaning |
|---|---|
base_url / baseUrl | Lore server origin, without a trailing slash |
api_token / apiToken | bearer token when the server uses API_TOKEN |
client_type | runtime identity sent to Lore: codex, claudecode, pi, openclaw, or hermes |
| startup hook | loads boot memory for the current runtime |
| prompt hook | fetches recall candidates for the current user prompt |
| MCP tools | read, search, create, update, move, and delete Lore memory nodes |
Restart the agent after changing plugin files, MCP config, hooks, or token values. Codex users should open /hooks and trust Lore hooks if prompted.
After connection is verified, move duplicated durable instructions out of local agent docs and into Lore. Keep only bootstrap guidance locally.