Skip to content

[proposal] CLI-desktop conversation sync (#61967) - #61969

Open
giruuuuj wants to merge 2 commits into
anthropics:mainfrom
giruuuuj:feat/cli-desktop-sync-proposal-61967
Open

[proposal] CLI-desktop conversation sync (#61967)#61969
giruuuuj wants to merge 2 commits into
anthropics:mainfrom
giruuuuj:feat/cli-desktop-sync-proposal-61967

Conversation

@giruuuuj

Copy link
Copy Markdown

Summary

Feature proposal for syncing Claude Code CLI conversation history with the Claude desktop app, enabling users to browse and review sessions from either interface.

Closes #61967

Problem

CLI sessions are local-only (stored in ~/.claude/projects/**/*.jsonl) and invisible in the desktop app. Users must choose between CLI power-user workflow and desktop browsing UI.

Proposed Architecture

Three options analyzed in the proposal document:

  1. Account-based sync (recommended) � both products push/pull metadata via Claude API keyed to user account, mirrors Codex/ChatGPT pattern
  2. Local storage bridge � CLI writes session metadata to desktop app's storage directory
  3. Shared session format � both products adopt same .jsonl schema and storage location

Existing Infrastructure

Claude Code already has session IDs, feedback IDs, resume mechanism, and stats cache � the plumbing partially exists. The gap is a shared metadata index that both products can read.

giruuuuj added 2 commits May 24, 2026 12:21
Adds desktop-session-sync plugin that bridges CLI session transcripts
(~/.claude/projects/**/*.jsonl) to the Claude desktop app's conversation
list by synthesising local_<uuid>.json metadata files.

Includes:
- Python sync script (hooks/sync_sessions.py) with dry-run support
- PostToolUse hook for auto-sync after transcript writes
- /sync-desktop-sessions slash command for on-demand sync
- Cross-platform support (macOS, Windows, Linux)
- Full plugin README, updated feature proposal, and CHANGELOG
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature Request: Sync CLI conversation history with Claude desktop app

1 participant