titan-memory-cli

Install the titan command with npm.

Titan Memory is a local-first memory runtime for coding agents. This npm package gives Codex and other agents a titan command without requiring a PyPI install.

Install for Codex

Run one command:

npx -y titan-memory-cli@latest setup codex

That command prepares Titan, creates the Codex memory folder, asks which extraction model to use, configures the required nomic-embed-text:v1.5 embedding model, installs the Codex plugin from Titan's bundled official-format marketplace snapshot, patches Codex MCP config, and runs a health check.

Then do the manual safety check Codex requires:

/hooks
trust python3 ${PLUGIN_ROOT}/scripts/titan_codex_hook.py
/mcp
confirm titan-memory

Install the CLI globally

Optional, if you want titan available on your PATH:

npm install -g titan-memory-cli

Verify:

titan --help
titan codex list-tools

On first run, the wrapper creates a Python virtual environment at:

~/.titan/npm-python

and installs Titan's Python dependencies there.

Codex requires manual hook trust. Titan does not bypass Codex's /hooks safety gate.

Manual Codex Plugin Install

If you only want to install the plugin through Codex's official marketplace commands, use:

codex plugin marketplace add kuwosaad/titan-memory-codex
codex plugin add titan-memory@titan-memory-codex

That is plugin-only. For the complete setup, including model selection and Titan runtime config, run:

npx -y titan-memory-cli@latest setup codex

Storage

Codex memory is isolated by default under:

~/.titan/agents/codex

Development Checks

npm test
npm run pack:check

npm test validates the bundled Codex marketplace layout and confirms the local Titan MCP tool list still loads.

Environment variables

• TITAN_NPM_VENV: override the Python venv path
• TITAN_NPM_NO_VENV=1: run with system Python instead of the managed venv
• PYTHON: choose the Python executable used to create the venv

Links

• Codex plugin: https://github.com/kuwosaad/titan-memory-codex
• CLI source: https://github.com/kuwosaad/titan-memory-cli
• License: Apache-2.0