ay-bh

Chat History — Communication skill for Claude Code

Communication community

Search, inspect, and export Claude Code, Cursor & Codex history.

How to install Chat History

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ay-bh/chat-history and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Chat History does

Search, inspect, and export Claude Code, Cursor & Codex history.

Alternatives in Communication

Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★
Qiaomu Anything To Notebooklm — Claude Skill: Multi-source content processor for NotebookLM 1.4k ★
Agent Kit — Give Claude/Cursor email powers 631 ★

README

chat-history

CLI for **agents** to search, inspect, and export **Claude Code**, **OpenAI Codex**, and **Cursor** conversation history.

Most usage is via an agent skill (`SKILL.md`) that tells Claude Code / Codex / Cursor when and how to call this tool — not interactive human browsing.

Agent using chat-history to summarize past project work

Scoring logic ported from [claude-historian-mcp](https://github.com/Vvkmnn/claude-historian-mcp), [claude-history](https://github.com/raine/claude-history), and [search-sessions](https://github.com/sinzin91/search-sessions), with Cursor transcript parsing inspired by [cursor-history](https://github.com/S2thend/cursor-history).

Setup (for agents)

cargo install chat-history

`cargo install` puts `chat-history` and `ch` on `PATH` (`~/.cargo/bin/`).

The first time you run `chat-history` / `ch`, it quietly installs the bundled agent skill to:

~/.claude/skills/chat-history/SKILL.md
$CODEX_HOME/skills/chat-history/SKILL.md (or ~/.codex/...)
~/.cursor/skills/chat-history/SKILL.md

On Windows, the same paths are under `%USERPROFILE%`. Later CLI upgrades refresh **managed** copies automatically (those written by this CLI, tracked via a `.chat-history-managed` sidecar). User-edited skills are left alone. Skills installed by older versions without that sidecar are left alone by the quiet path — run `install-skill` once after upgrading to adopt them.

Optional explicit install / reinstall:

chat-history install-skill           # refresh managed + adopt legacy (pre-sidecar) installs
chat-history install-skill --force   # overwrite even user-edited skills

The skill is active immediately — no restart needed.

Running inside agent sandboxes

Codex, Claude Code and Cursor can run commands in a sandbox that allows writes only inside the project and temporary directories. The caches live under `~/.chat-history/cache`, so a sandboxed search ma