conversation-history-recorder

Record structured conversation history for workspace projects as Markdown files.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/KwongFuk/codex-skills --skill conversation-history-recorder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conversation-history-recorder
Source: https://github.com/KwongFuk/codex-skills/tree/main/workspace/conversation-history-recorder
Command: npx skills add https://github.com/KwongFuk/codex-skills --skill conversation-history-recorder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Record structured conversation history for any project under /home/gguo/code. Use when a task touches a workspace project, when user instructions must be remembered exactly, or when Codex should preserve project problems, feedback, and user choices across turns without logging tools or code-level implementation details.

Core Features & Use Cases

  • Stores logs under /home/gguo/code/history/.
  • Keeps one Markdown file per project, named after the top-level project directory (e.g., eye, verl-gf, or video-nerv).
  • If the task is not tied to a single project, uses /home/gguo/code/history/_workspace.md and records the involved projects in the Context of the entry.
  • Entries follow a defined template, capturing context, problem/goal, user instruction, Codex feedback, user choices, and status.

Quick Start

After each user turn, append a new history entry to the relevant project file under /home/gguo/code/history.

Frequently Asked Questions about conversation-history-recorder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record and preserve conversation history for workspace projects?

To record conversation history, append structured entries to Markdown files stored under /home/gguo/code/history, capturing context, user instructions, feedback, and choices after each turn. This preserves project problems and decisions across conversations without logging code-level details.

What is the best way to maintain a durable project conversation log in Markdown?

The best way to maintain a durable project conversation log is using one Markdown file per project, named after the top-level directory, updating the file with a defined template after each user turn to ensure instructions and choices are preserved exactly.

How does conversation history recording work for tasks spanning multiple workspace projects?

Conversation history recording for multi-project tasks uses a shared _workspace.md file. The entry records the involved projects within the Context section, ensuring cross-project tasks are documented without forcing a single project file.

Does the conversation history recorder log code-level implementation details and tool outputs?

No, the conversation history recorder does not log code-level implementation details. It specifically preserves project problems, user instructions, Codex feedback, and user choices across turns to maintain a clean project context.

Can I use this conversation recorder for projects not located under /home/gguo/code?

No, this conversation recorder is specifically scoped to preserve history for projects under /home/gguo/code. Tasks not tied to a single project within this workspace are logged to a general _workspace.md file, but external projects are not supported.