// readme

mekugi

A mekugi is the small peg that pins a Japanese sword’s handle to the blade. Take it out and the handle comes off. Leave it in and the blade is still the blade.

Mekugi keeps stock Codex agents working from current, compact context across long sessions, compaction, and delegates, and lets you see what they are doing, what they are about to do, and what they have done. Codex keeps editing, execution, the sandbox, permissions, command sessions, and patch review. Invocation overrides leave Codex configuration unchanged.

Why Mekugi · Install · Quick start · Guides · Documentation

Why Mekugi

Agents work from current, compact context

  • Compaction that rereads sources. Codex context resets without generating a handover summary. Agents can select files, skills and captured changes needed for unfinished work; Mekugi reads them before the conversation continues, so work resumes from current source text.
  • Agent-chosen checkpoints. Agents can [compact at safe…