git404hub

what is context-manager fr?

zhexulong/context-manager — explained in plain English

Analysis updated 2026-05-18

13JavaScriptAudience · developerComplexity · 3/5Setup · moderate

tl;dr

Tool that mines agent chat history into reusable guidance files (decisions, processes, conventions) so later Codex sessions can pick up prior context.

vibe map

mindmap
  root((context-manager))
    Inputs
      Codex chat history
      Repo root path
      Prompt templates
    Outputs
      Working-memory folder
      Guidance folder
      Recall skill
    Use Cases
      Persist agent decisions
      Reuse coding conventions
      Compact long sessions
    Tech Stack
      JavaScript
      Node
      Codex hooks
      npm

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 make with this?

VIBE 1

Extract durable decisions and conventions from a Codex chat into a guidance folder

VIBE 2

Wire Codex hooks into a target repo via context-manager init

VIBE 3

Replay pending refinement jobs and capture LLM failure logs

VIBE 4

Let later agent sessions pull guidance on demand instead of re-reading chat history

what's the stack?

JavaScriptNodenpmCodex

how it stacks up fr

zhexulong/context-manager09catho/axonabdulrdeveloper/react--tic-tac-toe
Stars131313
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderateeasy
Complexity3/54/51/5
Audiencedeveloperresearcherdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Currently targets the Codex agent only, Claude Code and other agents are planned but not built.

in plain english

The context-manager project turns agent conversations into reusable guidance and context. The README is mostly in Chinese with one English subtitle. The premise is that after an AI coding agent has been used for a while, the chat history grows long but the genuinely useful conclusions get harder to find: either important context gets buried, or it gets dropped when the session is compacted or ends. This tool tries to extract the parts worth keeping so that later agent sessions can pick them up directly. The core flow starts from a conversation, runs a refining step, writes the result into a working-memory folder, refines again into a guidance folder, and then later agents read from guidance on demand. The guidance area is split into three plain categories: decisions, processes, and conventions. The README states the tool currently targets the Codex agent and that support for other agents such as Claude Code is planned next, not built yet. Two install paths are documented. The npm path is to install the @omnimer/context-manager package globally and then run context-manager init --repo-root . inside the target repository. The source path clones this repo, runs npm install, and then runs the bin script with --repo-root pointing at the target. The init step writes a Codex hook configuration into the target repo that points at the already-installed runtime, instead of copying the hooks or scripts folders. A short list of common commands names npm test, a compile script, a lint script, a replay-pending script, and a smoke end-to-end script. The current status section says the integration goes through Codex hooks, that working-memory and guidance are produced, and that a guidance-recall mechanism lets later sessions pull what they need. Other notes describe default prompt templates under scripts/prompts that can be overridden through an environment variable, report folders for pending replays and LLM failure logs, project-level hooks declared in .codex/config.toml, and a guidance-recall skill installed under the user's home Codex skills folder. The compile step takes the latest verified state as authoritative when sources conflict, so stale guidance is not preserved. The README ends with a list of reference repositories that inspired the design, including claude-memory-compiler, openai's codex and codex-plugin-cc, and zilliztech's memsearch, and an invitation to file issues and pull requests, with thanks to the linux.do community.

prompts (copy fr)

prompt 1
Install @omnimer/context-manager globally and initialize it inside my current repo with the right Codex hook setup
prompt 2
Show me what the working-memory and guidance folders look like after one refine cycle in context-manager
prompt 3
Override the default prompt templates in context-manager using the environment variable and a custom scripts/prompts directory
prompt 4
Run the smoke end-to-end script for context-manager and walk me through what each step does
prompt 5
Sketch how I would extend context-manager to support Claude Code in addition to Codex

Frequently asked questions

what is context-manager fr?

Tool that mines agent chat history into reusable guidance files (decisions, processes, conventions) so later Codex sessions can pick up prior context.

What language is context-manager written in?

Mainly JavaScript. The stack also includes JavaScript, Node, npm.

How hard is context-manager to set up?

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

Who is context-manager for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.