Local Conversation History
Lists recent local Claude Code and OpenAI Codex conversations for a workspace with one read-only command.
UtilitiesIntermediate★ 1,323⑂ 212AI score 9/10Last updated: Aug 8, 2026
What it does
- Prints a project-scoped inventory of recent Claude Code and Codex conversations in a single run.
- Combines every active config home (
~/.claude, profile homes,CLAUDE_CONFIG_DIR) with every long-term archive registered in~/.claude/history-sources.json, de-duplicating session IDs. - Sorts and filters by internal JSONL timestamps instead of file mtime, so copying or migrating archives never distorts chronology.
- Renders presentation-ready Markdown (or JSON) with titles, timezone-qualified timestamps, provenance labels, session IDs, and archive/test flags.
- Excludes internal sub-agent and smoke-test noise by default; opt in with
--include-subagents/--include-automated.
Who it's for
- Developers juggling many repos who keep losing track of where a past session happened.
- Users running both Claude Code and Codex CLI with history scattered across stores.
- Anyone who archives conversation history to external drives but still wants one unified listing.
- People who need an exact session ID before resuming work.
Examples
- "Show my last 10 conversations for this repo" → a table of titles, timestamps, session IDs, and sources.
- "List only Codex threads from last week, including archived ones" →
--source codex --include-archived --from-date .... - "Give me an inventory across all workspaces" →
--all-projects, then pick the session ID to continue with.
Note: full-text search, deleted-file recovery, and resuming work are handled by sibling skills (
claude-code-history-files-finder,continue-claude-work,continue-codex-work).
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the daymade-claude-code/local-conversation-history folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/local-conversation-history/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/daymade-claude-code/local-conversation-history ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Confirm Python 3 is available: run
python3 --version. - Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy this skill in:
cp -r claude-code-skills/daymade-claude-code/local-conversation-history ~/.claude/skills/ - Optional: make the script executable —
chmod +x ~/.claude/skills/local-conversation-history/scripts/list_local_history.py - Restart Claude Code and ask: "list my recent local conversations".
- Optional: register durable archive paths in
~/.claude/history-sources.jsonso they are searched on every run. - On Windows, invoke it as
py <skill-dir>/scripts/list_local_history.py --cwd . --limit 10.
View source on GitHub ↗License: MIT