AgentHist v0.2.2

Improved

• Batch export, import, and cross-Agent conversion now continue when another session has recoverable state gaps or a target conflict.
• Cross-Agent conversion preserves readable conversation content while reporting skipped or reconstructed optional records.

Fixed

• Claude Code native migration no longer rejects readable sessions because of coordinator state or incomplete optional sidecars.
• Codex restores sessions when the rollout is valid but its SQLite thread metadata is missing or inconsistent.
• OpenCode tolerates unknown relation metadata and missing parent links, while excluding pending input and active revert state from migration.
• Pi preserves sessions with external or cyclic parent references by safely detaching unavailable runtime relations.

Install: npm install -g agenthist@0.2.2

Full changelog

AgentHist v0.2.1

Fixed

• Codex compaction markers no longer block otherwise readable conversions.
• Codex resumed sessions with repeated session_meta records now work across scanning, export, import, conversion, workspace mapping, and provider rebinding.

Thanks @shuguangnet for #1.

Install: npm install -g agenthist@0.2.1

Full changelog

AgentHist v0.2.0

Added

• Added agenthist resume to continue any captured conversation with Codex, Claude Code, OpenCode, or Pi. Native sessions open directly; cross-Agent routes show conversion impact before a transactional write.
• Added an interactive history browser for previewing, continuing, renaming, tagging, archiving, and deleting captured conversations.
• Added interactive .agenthist file selection when inspect or import is run without a file path.

Improved

• Reused existing cross-Agent continuations when the source is unchanged, while creating a new target when the source conversation advances.
• Refreshed detected history incrementally before interactive history and resume workflows.
• Improved Agent CLI discovery across Linux, macOS, and Windows.

Fixed

• Fixed Codex history discovery without config.toml by using the built-in openai provider.
• Fixed the first cross-Agent continuation into an initialized OpenCode database with no existing sessions.

Install: npm install -g agenthist@0.2.0

Full changelog

AgentHist v0.1.2

Added

• Added interactive export for browsing history by Agent and workspace, previewing conversations, selecting sessions, and choosing the archive path.
• Added repeatable --workspace filters and --all for explicit full exports.

Improved

• Separated unavailable sessions from selectable history while keeping them visible in export review and results.
• Updated the README, command reference, FAQ, and built-in Skill for full and filtered export workflows.

Fixed

• Fixed Codex archive validation for equivalent Windows paths, including verbatim and normalized path forms.

Install: npm install -g agenthist@0.1.2

Full changelog

AgentHist v0.1.1

Highlights

• Added directory candidates and keyboard completion to interactive workspace mapping.
• Made bulk exports skip and report blocked sessions while keeping explicit session exports strict.
• Improved CLI readability with aligned output, semantic colors, compact technical details, and in-place progress.
• Fixed Codex path handling on Windows and isolated orphaned OpenCode session diff files.

Install

npm install -g agenthist@0.1.1

Full Changelog: v0.1.0...v0.1.1

AgentHist v0.1.0

AgentHist 0.1.0 is the first public release.

Highlights

• Browse, search, rename, tag, archive, and delete captured sessions in the AgentHist library.
• Export selected history and restore it on another machine.
• Convert sessions between Codex, Claude Code, OpenCode, and Pi with per-session loss reporting.
• Preview native writes and recover or roll them back through transactions.
• Extract recurring experience from multiple sessions into evidence-backed review material.
• Install AgentHist usage guidance for supported Agents.

Install

npm install -g agenthist

Node.js 24 or later is required.

Documentation

• README
• Command reference

Scope

AgentHist works with history data. Agent connection settings and credentials are not collected or transferred.