explaingit

novasplace/csm-codex-plugin

Analysis updated 2026-05-18

0PowerShellAudience · developerComplexity · 2/5Setup · moderate

TLDR

A Windows plugin that gives OpenAI's Codex coding assistant persistent memory across sessions, storing goals, notes, and history in a local database.

Mindmap

mindmap
  root((repo))
    What it does
      Cross session memory
      Goal and task tracking
      Checkpoint saving
      Context history log
    Tech stack
      PowerShell
      Node.js
      SQLite
      PostgreSQL optional
    Use cases
      Resume coding sessions
      Track project goals over time
      Give Codex persistent context
    Audience
      Developers
      Codex users
    Setup
      Extract zip and run installer
      Windows only
      Restart Codex after install

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give the Codex coding assistant memory that persists between separate work sessions.

USE CASE 2

Track ongoing project goals, notes, and a work log automatically as you code with Codex.

USE CASE 3

Save checkpoints so a coding session can resume close to where it left off.

USE CASE 4

Switch the plugin's storage from local SQLite to PostgreSQL or OpenAI embeddings for larger setups.

What is it built with?

PowerShellNode.jsSQLitePostgreSQLTypeScript

How does it compare?

novasplace/csm-codex-pluginadi4x4/agentpingamu2mod/gamesavesaver
Stars000
LanguagePowerShellPowerShellPowerShell
Setup difficultymoderateeasyeasy
Complexity2/51/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Windows only, requires a specific Node.js version and a restart of Codex after installing.

The README does not state a license, so usage terms are unclear.

In plain English

This project is a plugin that gives OpenAI's Codex coding assistant a persistent memory that carries over between separate sessions. Normally an AI coding assistant forgets everything once a conversation ends, but this plugin stores information like the assistant's ongoing goals, notes about the project, checkpoints, and a running work log in a local database, so the next session can pick up roughly where the last one left off. The plugin bundles a full set of memory related tools and behaviors, including onboarding steps for first use, ways to re-enter an existing project, a record of the assistant's beliefs and self-model, a history log called AgentBook, checkpoint saving, a context cache, goal tracking, automatic summarization of long histories, usage telemetry, and automation for handing work off between sessions. It is built specifically for Windows and requires a particular version of Node.js to run. Installation involves extracting a ZIP file, opening PowerShell in that folder, and running a single install script. That script checks every bundled file against a list before copying itself into a fixed location under the user's local application data folder, then registers itself with Codex's plugin system. After installing, the user restarts Codex, reviews and approves the plugin's hooks, and can ask Codex to check that its database connection is working. By default the plugin stores its data locally using SQLite, a lightweight file based database, though it can be configured to use PostgreSQL or OpenAI's embedding service instead by editing a configuration file. The project takes data handling seriously: the downloaded archive itself contains no credentials or personal file paths, and the installer verifies file integrity using checksum files before it will proceed, refusing to install if anything looks modified or incomplete.

Copy-paste prompts

Prompt 1
Walk me through installing this Cross-Session Memory plugin for Codex on Windows.
Prompt 2
Explain what tools and hooks this plugin adds to Codex once installed.
Prompt 3
Help me configure this plugin to use PostgreSQL instead of the default local SQLite database.
Prompt 4
Show me how to verify the installer's checksum files before running install.cmd.
Prompt 5
Explain how csm_runtime_status confirms the plugin's database connection is working.

Frequently asked questions

What is csm-codex-plugin?

A Windows plugin that gives OpenAI's Codex coding assistant persistent memory across sessions, storing goals, notes, and history in a local database.

What language is csm-codex-plugin written in?

Mainly PowerShell. The stack also includes PowerShell, Node.js, SQLite.

What license does csm-codex-plugin use?

The README does not state a license, so usage terms are unclear.

How hard is csm-codex-plugin to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is csm-codex-plugin for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.