Claude Desktop Importer — Development skill for Claude Code

claude-desktop-importer

English | [简体中文](https://github.com/Leeiio/claude-desktop-importer/blob/main/README.zh-CN.md)

Bring your Claude Code CLI sessions into the Claude Desktop sidebar: all of them, with their real titles, in the right order.

Claude Desktop already has **Help → Troubleshooting → Import Claude Code CLI sessions…**, but it:

• silently skips sessions started through the Agent SDK or claude -p (headless, sdk-* entrypoints);
• silently skips projects whose folder is not marked trusted in ~/.claude.json under that exact path;
• titles every session with its first prompt, even when Claude Code generated a title or you set one with /rename (anthropics/claude-code#89857);
• uses the transcript's file modification time as "last activity", so the sidebar order is wrong: Claude Code appends metadata long after the last message (anthropics/claude-code#83203);
• tells you nothing about what it skipped, or why.

This tool does the same job transparently, and can repair the sessions the built-in Import already added.

Install

Python 3.9 or newer, no dependencies. With [uv](https://docs.astral.sh/uv/) you can run it without installing anything:

uvx claude-desktop-importer scan

Or install the command once:

uv tool install claude-desktop-importer     # or: pipx install claude-desktop-importer

Upgrade later with `uv tool upgrade claude-desktop-importer` (or `pipx upgrade claude-desktop-importer`); `uvx claude-desktop-importer@latest` always runs the newest release.

To run from source instead:

git clone https://github.com/Leeiio/claude-desktop-importer.git
cd claude-desktop-importer
python3 -m claude_desktop_importer scan

Usage

The examples use the installed command; with uvx, put `uvx` in front (`uvx claude-desktop-importer import --apply`). Every command only shows what it