Add 'handoff' command: paste-ready prompts for continuing in another AI agent

The new feature closes the 'I want to switch agents mid-conversation' UX
gap. One command produces everything needed to keep going in Claude.ai,
ChatGPT, Cursor, or any other chat-style AI tool — without re-explaining
context manually.

USAGE
  claude-backup handoff <id-prefix>                  # print to stdout
  claude-backup handoff <id-prefix> | pbcopy         # macOS — straight to clipboard
  claude-backup handoff <id-prefix> | xclip ...      # Linux
  claude-backup handoff <id-prefix> -o handoff.md    # save to a file
  claude-backup handoff <id-prefix> --lang en|ru     # force wrapper language

OUTPUT SHAPE
A self-contained prompt with:
  1. Framing line ('You are continuing a conversation I started in <source>')
  2. Original task (from session title or first user prompt)
  3. Started date + dialogue-only message count
  4. The full clean transcript (no tool noise — keeps paste size sane)
  5. Closing line asking the new agent to acknowledge and wait

DESIGN CHOICES
- Always uses the dialogue-only render so paste size stays small. 200-msg
  session is typically 80-200 KB — fine for any modern hosted assistant.
- Wrapper language auto-detects Cyrillic in the title or first prompt and
  picks Russian; otherwise English. Override with --lang. The transcript
  itself is unchanged either way (the new agent will speak whatever
  language was in the conversation).
- The clipboard tip prints to stderr so '| pbcopy' captures only the
  prompt, not the helper text.
- Reuses the same session-prefix lookup as 'export', so any unique 8-char
  prefix works.

CODE
- exporter.py: new render_handoff(), detect_handoff_language(),
  bilingual templates, source-label maps.
- cli.py: extracted shared _resolve_session_or_exit() so 'export' and
  'handoff' share the prefix-matching + ambiguity error path.
- 10 new tests covering: framing, dialogue-only count, language detection
  for both Cyrillic and ASCII sessions, explicit --lang override, source
  label, CLI stdout vs --output, missing-session error, and the
  stderr-discipline contract for the clipboard tip.

DOCS
README, README.ru, QUICKSTART, PROMPT all gain a handoff section. The
PROMPT additionally instructs the AI assistant to plant a seed about
'handoff' near the end so users learn about it during onboarding.

95/95 tests pass, 91% coverage.

Author: sedelev

PROMPT.md

@@ -32,6 +32,7 @@ The full path:
 6. Pick an interesting session with me and have me run `claude-backup export <8-char-prefix> --output ./backups/`. By default this writes two files: `<id>.md` (clean dialogue, only my prompts and Claude's text replies) and `<id>.full.md` (everything — tool calls, tool results, AND any subagent transcripts the session spawned). Explain when to use each.
 7. Have me `open ./backups/<filename>.md` (macOS) or `xdg-open` (Linux) to view the result. Ask what I think.
 8. If I want a full backup of everything, have me run `claude-backup export-all --output ~/claude-backups`. Explain that the output is split first by source — `code/` and `cowork/` subfolders — and inside each, organised by project (Code mirrors my real working dirs, Cowork uses the friendly codename like `beautiful-charming-curie` that Cowork itself generates).
+9. Mention one more useful command for later: `claude-backup handoff <prefix> | pbcopy` (macOS) or `| xclip -selection clipboard` (Linux). It produces a paste-ready prompt I can drop into Claude.ai, ChatGPT, Cursor, or any other AI assistant to continue the same conversation there. Don't make me try it now unless I ask — just plant the seed so I know it exists.
 
 If a command errors: help me debug, don't just dump a fix. Common issues —
 - "Claude data not found" → I haven't used either Claude Code or Cowork on this machine yet
@@ -65,6 +66,7 @@ Start with step 1.
 6. Выбери со мной одну сессию и вели мне `claude-backup export <8-символьный-префикс> --output ./backups/`. По умолчанию создаются два файла: `<id>.md` (чистый диалог — только мои промпты и текстовые ответы Claude) и `<id>.full.md` (всё: tool-вызовы, tool-результаты И transcripts subagent'ов которые сессия порождала). Объясни когда использовать каждый.
 7. `open ./backups/<filename>.md` (macOS) или `xdg-open` (Linux) — посмотреть результат. Спроси что я думаю.
 8. Если хочу выгрузить всё — `claude-backup export-all --output ~/claude-backups`. Объясни что вывод сначала разделён по источнику — подпапки `code/` и `cowork/`, — а внутри каждой организован по проекту (Code зеркалит реальные рабочие директории, Cowork использует дружелюбный кодноим типа `beautiful-charming-curie` который Cowork сам генерирует).
+9. Упомяни ещё одну полезную команду на будущее: `claude-backup handoff <prefix> | pbcopy` (macOS) или `| xclip -selection clipboard` (Linux). Она создаёт paste-ready промпт, который можно вставить в Claude.ai, ChatGPT, Cursor или любого другого AI-ассистента, чтобы продолжить тот же разговор там. Не заставляй пробовать сейчас если я не попрошу — просто посади семечко чтобы я знал что это есть.
 
 Если команда выдаёт ошибку — помоги отладить, не вываливай готовый фикс. Частые проблемы:
 - "Claude data not found" → я ещё не пользовался ни Claude Code, ни Cowork на этой машине

QUICKSTART.md

@@ -133,7 +133,25 @@ The clean version is typically **half the size** of the audit copy and is what y
 
 ---
 
-## Step 6 — Export everything at once
+## Step 6 — Continue this conversation in another agent
+
+Want to keep going on this session in **claude.ai web**, **ChatGPT**, **Cursor**, or another AI tool? One command makes a paste-ready prompt:
+
+```bash
+# macOS — straight to your clipboard
+claude-backup handoff abc12345 | pbcopy
+
+# Linux
+claude-backup handoff abc12345 | xclip -selection clipboard
+```
+
+Now open the other agent, paste, and hit send. The pasted message tells the new agent it's continuing your conversation, includes the full clean transcript, and asks it to acknowledge context. After it confirms, you keep typing as if you'd never switched.
+
+The wrapper text auto-detects Russian/English from the session, so you don't have to think about it. Pass `--lang en` or `--lang ru` to override, or `--output handoff.md` to save the prompt to a file instead of stdout.
+
+---
+
+## Step 7 — Export everything at once
 
 ```bash
 claude-backup export-all --output ./backups/                    # both files per session

README.md

@@ -53,6 +53,10 @@ claude-backup export f7a07eec --output ~/claude-backups/
 
 # Export everything from both sources (organised by source folder)
 claude-backup export-all --output ~/claude-backups/
+
+# Continue a session in a DIFFERENT agent — paste-ready prompt to your clipboard
+claude-backup handoff f7a07eec | pbcopy        # macOS
+claude-backup handoff f7a07eec | xclip -selection clipboard   # Linux
 ```
 
 By default each export produces **two files** side-by-side:
@@ -162,6 +166,36 @@ claude-backup --cowork-home /path/to/cowork list                          # only
 claude-backup --claude-home /a --cowork-home /b list                      # both, custom roots
 ```
 
+### Continue a session in another agent (`handoff`)
+
+Sometimes you want to keep going in a *different* AI tool — moving a Cowork conversation to claude.ai web, picking up a Code session in ChatGPT or Cursor, sending the discussion to a colleague's agent. The `handoff` command produces a single paste-ready prompt that:
+
+- Tells the new agent it's continuing your conversation
+- Names the source (Claude Code or Claude Cowork) and the original task
+- Drops the full dialogue-only transcript inline (no tool noise, so it stays paste-friendly)
+- Asks the new agent to acknowledge context and wait for your next message
+
+```bash
+claude-backup handoff f7a07eec                                  # print to stdout
+claude-backup handoff f7a07eec | pbcopy                         # macOS — straight to clipboard
+claude-backup handoff f7a07eec | xclip -selection clipboard     # Linux
+claude-backup handoff f7a07eec --output ./handoff.md            # save to a file
+claude-backup handoff f7a07eec --lang en                        # force English wrapper
+claude-backup handoff f7a07eec --lang ru                        # force Russian wrapper
+```
+
+The wrapper language auto-detects from the session: Cyrillic in the title or first prompt → Russian wrapper, otherwise English. The transcript itself is unchanged — the new agent will respond in whatever language the conversation was in.
+
+Workflow:
+
+1. Run `claude-backup handoff <id> | pbcopy`
+2. Open Claude.ai (or ChatGPT, Cursor chat, Perplexity, anywhere)
+3. Paste into a fresh conversation
+4. The agent reads the context, acknowledges in 1–2 sentences
+5. You type your next message — the conversation continues there
+
+A 200-message session typically packs into 80–200 KB of text — fine for context windows of any modern hosted assistant.
+
 ---
 
 ## Output format
@@ -229,6 +263,7 @@ Claude Code generates the AI-title **once**, near the start of a session, and ne
 ## Behaviour
 
 - **Two sources, one CLI.** Both Claude Code (`~/.claude/projects/`) and Claude Cowork (`~/Library/Application Support/Claude/local-agent-mode-sessions/`) are auto-discovered. If only one source exists on a machine, the other is silently skipped.
+- **Portable handoff.** The `handoff` command produces a paste-ready prompt that lets you continue any session in a different AI agent (Claude.ai, ChatGPT, Cursor, etc.). The wrapper auto-detects Russian/English from the session.
 - **Subagents recovered.** Both Code and Cowork spawn subagent transcripts under `<session-id>/subagents/agent-*.jsonl`. The full export pulls them in as separate sections; minimal mode drops them. The frontmatter's `subagents:` count tells you how many were attached.
 - **Reads the real Claude Code format.** Metadata (first prompt, message count, created timestamp, AI title) is computed by streaming the `.jsonl` directly. No `sessions-index.json` is required — Claude Code doesn't actually create one.
 - **AI-titles surfaced.** When the recording app emits an `ai-title` event, the title shows in `list` output and becomes the document heading.
@@ -251,7 +286,7 @@ pytest -v --cov=claude_backup
 
 CI runs on Python 3.9, 3.10, 3.11, and 3.12 — see [.github/workflows/test.yml](.github/workflows/test.yml).
 
-**Test coverage: 91%** (85/85 tests passing) — covers the real Claude Code format, the legacy spec format, the Cowork nested hierarchy, subagent discovery and rendering, edge cases (empty/corrupt JSONL, unicode, missing roots), `--mode` selection (both / minimal / full), the FS-aware project-path decoder, and CLI integration across both sources.
+**Test coverage: 90%** (95/95 tests passing) — covers the real Claude Code format, the legacy spec format, the Cowork nested hierarchy, subagent discovery and rendering, edge cases (empty/corrupt JSONL, unicode, missing roots), `--mode` selection (both / minimal / full), the FS-aware project-path decoder, and CLI integration across both sources.
 
 ### Project layout
 
@@ -273,7 +308,8 @@ tests/
 ├── test_cli.py
 ├── test_minimal.py        # Dialogue-only mode + --mode CLI flag
 ├── test_real_format.py    # Nested message shape, ai-title, project-path decoding
-└── test_cowork.py         # Cowork hierarchy + subagent rendering across sources
+├── test_cowork.py         # Cowork hierarchy + subagent rendering across sources
+└── test_handoff.py        # Paste-ready prompt for continuing in another agent
 ```
 
 ---

README.ru.md

@@ -53,6 +53,10 @@ claude-backup export f7a07eec --output ~/claude-backups/
 
 # Экспортировать всё из обоих источников (организовано по source-папкам)
 claude-backup export-all --output ~/claude-backups/
+
+# Продолжить сессию в ДРУГОМ агенте — paste-ready промпт прямо в буфер
+claude-backup handoff f7a07eec | pbcopy        # macOS
+claude-backup handoff f7a07eec | xclip -selection clipboard   # Linux
 ```
 
 По умолчанию каждый экспорт создаёт **два файла** рядом:
@@ -162,6 +166,36 @@ claude-backup --cowork-home /path/to/cowork list                          # то
 claude-backup --claude-home /a --cowork-home /b list                      # оба, кастомные пути
 ```
 
+### Продолжить сессию в другом агенте (`handoff`)
+
+Иногда хочется продолжить разговор в *другом* AI-инструменте — перенести Cowork-сессию в claude.ai web, подцепить Code-сессию в ChatGPT или Cursor, отправить разговор агенту коллеги. Команда `handoff` создаёт один paste-ready промпт, который:
+
+- Говорит новому агенту что он продолжает разговор
+- Называет источник (Claude Code или Claude Cowork) и исходную задачу
+- Подсовывает полный dialogue-only транскрипт (без tool-шума, чтобы paste не разросся)
+- Просит нового агента подтвердить контекст и подождать следующего сообщения
+
+```bash
+claude-backup handoff f7a07eec                                  # печать в stdout
+claude-backup handoff f7a07eec | pbcopy                         # macOS — сразу в буфер
+claude-backup handoff f7a07eec | xclip -selection clipboard     # Linux
+claude-backup handoff f7a07eec --output ./handoff.md            # сохранить в файл
+claude-backup handoff f7a07eec --lang en                        # форсить English-обёртку
+claude-backup handoff f7a07eec --lang ru                        # форсить Russian-обёртку
+```
+
+Язык обёртки авто-определяется по сессии: если в title или первом промпте есть кириллица → русская обёртка, иначе английская. Сам транскрипт не меняется — новый агент ответит на том же языке что был в разговоре.
+
+Workflow:
+
+1. Запустить `claude-backup handoff <id> | pbcopy`
+2. Открыть Claude.ai (или ChatGPT, Cursor чат, Perplexity, что угодно)
+3. Вставить в новый разговор
+4. Агент читает контекст, подтверждает в 1–2 предложениях
+5. Печатаешь следующее сообщение — разговор продолжается там
+
+Сессия из 200 сообщений обычно укладывается в 80–200 КБ текста — нормально для context window любого современного хостед-ассистента.
+
 ---
 
 ## Формат вывода
@@ -226,6 +260,7 @@ Claude Code генерирует AI-title **один раз**, в начале 
 ## Поведение
 
 - **Два источника, один CLI.** И Claude Code (`~/.claude/projects/`), и Claude Cowork (`~/Library/Application Support/Claude/local-agent-mode-sessions/`) обнаруживаются автоматически. Если на машине только один источник — другой молча пропускается.
+- **Портативный handoff.** Команда `handoff` создаёт paste-ready промпт, чтобы продолжить любую сессию в другом AI-агенте (Claude.ai, ChatGPT, Cursor и т.д.). Обёртка авто-выбирает русский или английский по сессии.
 - **Subagents восстанавливаются.** И Code, и Cowork порождают transcripts subagent'ов в `<session-id>/subagents/agent-*.jsonl`. Полный экспорт подтягивает их как отдельные секции; minimal-режим их роняет. Поле `subagents:` в frontmatter показывает сколько было приклеено.
 - **Читает реальный формат Claude Code.** Метаданные (первый промпт, число сообщений, дата создания, AI-title) считаются прямо из `.jsonl` потоковым чтением. Никакого `sessions-index.json` не требуется — Claude Code его на самом деле не создаёт.
 - **AI-titles на видном месте.** Если приложение записало событие `ai-title`, заголовок отображается в `list` и используется как H1 в Markdown-документе.
@@ -248,7 +283,7 @@ pytest -v --cov=claude_backup
 
 CI запускается на Python 3.9, 3.10, 3.11 и 3.12 — см. [.github/workflows/test.yml](.github/workflows/test.yml).
 
-**Покрытие тестами: 91%** (85/85 тестов проходят) — реальный формат Claude Code, legacy-формат из спеки, вложенная иерархия Cowork, обнаружение и рендеринг subagent'ов, edge-кейсы (пустой/битый JSONL, unicode, отсутствующие root'ы), выбор `--mode` (both / minimal / full), FS-aware декодинг путей, и интеграционные тесты CLI по обоим источникам.
+**Покрытие тестами: 90%** (95/95 тестов проходят) — реальный формат Claude Code, legacy-формат из спеки, вложенная иерархия Cowork, обнаружение и рендеринг subagent'ов, edge-кейсы (пустой/битый JSONL, unicode, отсутствующие root'ы), выбор `--mode` (both / minimal / full), FS-aware декодинг путей, и интеграционные тесты CLI по обоим источникам.
 
 ### Структура проекта
 
@@ -270,7 +305,8 @@ tests/
 ├── test_cli.py
 ├── test_minimal.py        # Dialogue-only режим + CLI флаг --mode
 ├── test_real_format.py    # Вложенный формат message, ai-title, декодинг путей
-└── test_cowork.py         # Cowork-иерархия + рендеринг subagent'ов в обоих источниках
+├── test_cowork.py         # Cowork-иерархия + рендеринг subagent'ов в обоих источниках
+└── test_handoff.py        # Paste-ready промпт для продолжения в другом агенте
 ```
 
 ---