Hologres:Integrate Hologres long memory service with AI coding tools

Check the installation status

openmemory status

Expected output:

==================================================
 Hologres OpenMemory Status
==================================================

  ✓ Qoder CLI v1.2.3 [detected]
     config: /Users/xxx/.qoder/plugins/cache/local/openmemory/1.2.3/.qoder-mcp.json

  ✓ Claude Code v0.1.1 [detected]
     config: /Users/xxx/.claude/settings.json

  ✓ Codex v0.1.1 [detected]
     config: /Users/xxx/.codex/plugins/cache/hologres-openmemory-plugins/openmemory/0.1.1/.codex-mcp.json

  CLI: /Users/xxx/.local/bin/openmemory (exists)

  ✓ Using credentials from /Users/xxx/.hologres-open-memory/config.json
     URL: http://<ENDPOINT>:80
     Key: om-xxxxxxxx
  Credentials: configured

  3/3 agent(s) installed

Verify in each AI coding tool

Qoder CLI: Start Qoder CLI and tell the agent a few personal facts in a conversation. Then, start a new session and ask about those facts to check whether memories are recalled automatically. You can also run /openmemory:health in a conversation to check the connection status of the long memory service.

Claude Code: Start Claude Code. The plugin loads automatically. Then, in a conversation, verify that memories persist across sessions.

Codex: Start Codex and run /openmemory:health to check the connection status of the long memory service. Then, verify memory recall in a conversation.

Credential storage

The installer stores the endpoint and API key in ~/.hologres-open-memory/config.json:

{
  "hologres_open_memory_url": "http://<ENDPOINT>:80",
  "hologres_open_memory_api_key": "om-xxxxxxxx"
}

To change the credentials, run one of the following commands:

# Interactive mode
openmemory config

# Or specify the parameters directly
openmemory config --url http://<ENDPOINT>:80 --key om-xxxxxxxx

Configuration files

Environment variables

On Mac and Linux, the installer writes the following environment variables to your shell profile (such as ~/.zshrc or ~/.bashrc):

# >>> hologres-open-memory >>>
export HOLOGRES_OPEN_MEMORY_URL="http://<ENDPOINT>:80"
export HOLOGRES_OPEN_MEMORY_API_KEY="om-xxxxxxxx"
# <<< hologres-open-memory <<<

On Windows, the installer uses setx to set the following user environment variables:

HOLOGRES_OPEN_MEMORY_URL=http://<ENDPOINT>:80
HOLOGRES_OPEN_MEMORY_API_KEY=om-xxxxxxxx

How do I check which AI coding tools are installed?

Run openmemory status. The command lists all supported tools and their installation status.

How do I change the configured endpoint or API key?

openmemory config --url http://<ENDPOINT>:80 --key om-xxxxxxxx

After you change the credentials, run the following command to update the configuration of each tool:

openmemory update

What do I do if the connection fails after installation?

Troubleshoot in the following order:

1. Verify that the endpoint includes the http:// prefix and a port number, such as :80.

2. Verify that the API key matches the value shown in the Hologres console. The key starts with om-.

3. Verify that your local environment can reach the endpoint of the long memory service. Run curl http://<ENDPOINT>:80/mcp to test connectivity.

4. If you use a public endpoint, verify that the IP whitelist is configured.

How do I uninstall the plugin for a specific tool?

openmemory uninstall

Select the tools to uninstall in the interactive prompt. You can also specify a tool directly:

openmemory uninstall --agents qodercli

How do I enter the credentials on the first installation, when no credentials are saved yet?

The installer prompts you to enter the service URL and API key. For information about how to obtain them, see Obtain connection information.

  Please enter your OpenMemory service credentials.

  Service URL: http://<ENDPOINT>:80
  API Key:  (input is hidden)

The installer then validates connectivity. If the validation succeeds, the installation continues.