Configure Remember
Configure what the hooks capture, where the memory is shared, and where inference runs. The integration works with the same settings file across Codex and Claude Code by default.
Settings file
The installer writes ~/.remember/coding-agent.json. Set REMEMBER_HOME to change the configuration and daemon state directory, or REMEMBER_CONFIG to specify the file directly. Restart the agent after changes. Scalar fields can also be set as environment variables such as REMEMBER_API_PORT; maps like harnesses, banks, and mapPathToBank belong in the file.
The service is local. Use apiPort if the default port is occupied, and set apiToken or REMEMBER_API_TOKEN if you want to require a local bearer token. Keep provider credentials and tokens out of version control.
Limit where memory runs
By default all projects can use the hooks, each with its own bank. To enable memory only in selected directories, merge these fields into the existing file:
{
"optInOnly": true,
"optInPaths": ["~/Projects/my-project"]
}
Opt-in paths match prefixes. List the path where you open the agent if you work in a separate directory. A mapPathToBank entry also opts that path in. That map lets you intentionally share a named bank; the longest matching prefix wins. Only map unrelated projects to the same bank if their memories are meant to be visible to one another.
Control capture and recall
| Setting | Effect |
|---|---|
disabled: true | Switches the integration off. |
retainSessions: false | Stops automatic transcript retention; recall and other memory actions stay available. |
autoInject: "none" | Disables automatic memory context; the agent can still use its tools. |
autoInject: "recall" | Default. Looks up relevant evidence before the agent acts. |
autoInject: "pages" | Uses Page search for automatic context. |
autoInject: "reflect" | Opts in to automated synthesis. It may spend time and tokens on a model call. |
See the integration guide for hook timeouts, exact fields, and source-include options. Explicit reflection is available by default without setting autoInject to "reflect".
Privacy and inference
The daemon, database, and logs are local. Hosted providers receive the memory content they process, including source excerpts in some requests. Local CLI adapters are not offline if their configured model is hosted. For on-device memory inference, select local Ollama and leave embedding settings local. Initial package and model downloads may still need network access. Remember does not change how Codex or Claude Code processes your ordinary coding prompts.
Treat memory, diagnostic logs, and backups as sensitive. Keep credentials out of transcripts. Use project opt-in or turn transcript retention off before starting a session if you do not want it saved.