liuyoumi

liuyoumi / codex-history

Public

A CLI tool to safely manage and purge local Codex conversation history

17
0
89% credibility
Found May 31, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A command-line tool that helps you view and safely delete your local Codex AI assistant conversation history, with confirmation prompts and verification to prevent accidental data loss.

How It Works

1
💬 You use an AI coding assistant

You've been using Codex to help with coding projects and now have lots of saved conversations.

2
🧹 You want to clean up old chats

Your conversation list is getting too long, and you want to remove ones you've finished with.

3
🔍 You check if the tool works

You run a quick check to make sure the tool understands your current setup before making any changes.

4
📋 You see all your conversations

The tool shows you every conversation with friendly titles, so you can find the ones you want to remove.

5
You choose what to delete
🎯
Delete specific chats

Select individual conversations by their short name or ID

📁
Delete by project

Remove all conversations from a particular project folder at once

6
✅ You confirm before anything is deleted

The tool shows you exactly what will be removed and asks you to type the conversation ID to confirm.

✨ Your conversations are cleaned up

The tool removes the selected conversations and verifies everything was deleted properly, freeing up space on your computer.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is codex-history?

codex-history is a CLI tool that helps you manage and clean up local Codex conversation history stored on your machine. Built in TypeScript, it reads Codex's local SQLite databases and JSON files to list your conversations, filter them by keyword or project directory, and safely delete what you no longer need. The tool requires explicit confirmation before any deletion, showing you exactly what will be removed and asking you to type the thread ID to proceed. It also handles orphaned data left behind when sessions are deleted externally.

Why is it gaining traction?

This fills a gap for developers who use Codex heavily and accumulate hundreds of local conversations. The tool respects your safety by refusing to delete the currently active thread and by verifying that references are actually removed after deletion. It works cross-platform on macOS, Windows, and Linux, and includes a `doctor` command to check compatibility after Codex updates. The `--grep` filtering and batch operations make it practical for users with large histories.

Who should use this?

Developers who use Codex Desktop and want to reclaim disk space from old conversations. Power users who work across multiple projects and need to filter conversations by working directory. Anyone frustrated by Codex's lack of built-in history management tools.

Verdict

codex-history does one thing well with careful safety engineering. The credibility score of 0.8999999761581421% reflects its low star count (17), so consider it early-stage software. Test coverage and documentation are present but minimal. If you need local Codex history cleanup, this is the dedicated tool for the job, but verify compatibility after each Codex update before running destructive commands.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.