Install codemem | OpenCode, Claude Code, and Codex Setup

Claude Code

Marketplace path

Install the plugin from the marketplace inside Claude Code. That is the normal path.

/plugin marketplace add kunickiaj/codemem
/plugin install codemem
/reload-plugins

The global CLI install is optional. It is only useful if you want codemem directly on your path for manual commands. Current builds can also start the viewer automatically and use the Claude sidecar runtime by default when you are running Claude Code without a separate API key.

OpenCode

Plugin path

Add the plugin to your OpenCode config, restart OpenCode, and let the plugin manage backend execution automatically.

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@codemem/opencode-plugin"]
}

The CLI is optional here too unless you want direct codemem commands in your shell.

Codex — early beta

Marketplace path

Install through Codex's own plugin marketplace, then restart Codex. There is no separate setup step.

codex plugin marketplace add https://github.com/kunickiaj/codemem.git
codex plugin add codemem@codemem

Codex support is early beta — capture works end-to-end and is being dogfooded. The plugin bundles its MCP config and hooks; codemem is used from your path when present and falls back to npx otherwise. Requires codemem 0.35+.

Verify it quickly

First check that the local viewer is up:

http://localhost:38888

If the viewer opens, the normal plugin path is working. The CLI is for manual commands and shell workflows, not a requirement for normal plugin use.

Need a manual check?

If you want to inspect things from the shell, use whichever command form matches your setup:

# if codemem is on your PATH
codemem stats
codemem db raw-events-status

# if you did not install the CLI globally
npx -y codemem stats
npx -y codemem db raw-events-status

Need the CLI on your path?

If you want repeated manual checks, local commands, or shell workflows, install the CLI separately:

npm install -g codemem

The CLI is optional in both OpenCode and Claude Code. Install it if you want shell access, not because the plugin path requires it.

System prerequisites

Install Node.js 24+ and npm first, then use the same Claude Code or OpenCode path.

node --version
npm --version

Repository / source path

If you want to inspect the source first or work from a checkout, clone the repository and follow the repo-specific setup.

git clone https://github.com/kunickiaj/codemem
cd codemem
# follow the repo-specific development setup

Need more?

For broader setup details, implementation notes, and current project instructions, head to the repository and the rest of the docs.