reprox-mcp

reprox-mcp is a TypeScript MCP server that lets coding agents search persistent repository memory created by cliper.

Reprox reads the persistent Local JSON memory created by Cliper and exposes it to MCP clients without inventing repository facts.

Tools

Tool	Use it when	Returns
search_memory	You need context for a question or task.	Matching memories grouped by retrieval category.
list_gaps	You need known risks or incomplete areas.	All gap summaries, high severity first.
get_gap	You need full context for one gap.	The gap and every memory it references.
get_related	You need memories connected to a known memory.	Outgoing and incoming relationship neighbors.
get_architecture	You need a structural repository overview.	All architecture and repository memories.
get_timeline	You need change or release history.	Commit, release, and timeline memories, newest first.

Quickstart

Build and link or install the package, then ensure the target repository has been initialized:

cliper init
reprox mcp --path /path/to/repository

If repository memory is missing, the server responds with: Repository memory is not initialized; run cliper init first.

Codex configuration

Add this to ~/.codex/config.toml:

[mcp_servers.reprox]
command = "reprox"
args = ["mcp", "--path", "/absolute/path/to/repository"]

Omit --path to use the server process's current working directory.

Development

npm install
npm run build
npm run pack-clean