convez.ai
SkillProdutividadeIntermediário
TokenTyrant

Claude Resurface

TokenTyrant/claude-resurface

Traga seu histórico de Claude do terminal/VS Code para o Desktop

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que importa seu histórico de sessões do Claude Code (CLI e VS Code) para o Claude Desktop app, gerando registros nativos de sessão para que suas conversas antigas apareçam na lista após reiniciar. Operação não-destrutiva, idempotente e exclusiva para macOS.

Instalação

$npx convez-ai TokenTyrant/claude-resurface

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Migrar sessões CLI para Claude Desktop
  • Recuperar histórico VS Code no Desktop app
  • Sincronizar conversas entre diferentes superfícies Claude

Veredito

Skill bem pensada e segura para usuários macOS que trabalham com múltiplas superfícies Claude. Solve um gap real no produto (falta de sincronização de sessões), com design defensivo (idempotente, não-destrutivo, com desfazer). Recomendado para quem alterna entre CLI/VS Code e Desktop.

README

A tradução para o português deste README ainda está na fila.

claude-resurface

Bring your Claude Code history with you. Resurface your existing CLI and VS Code sessions in the Claude Desktop app — your old conversations back in the session list, one restart away.

claude-resurface is a Claude Code skill: ask Claude to run it and — after you quit and reopen the Desktop app — your terminal/VS Code session history shows up in the Desktop app's session list. macOS · non-destructive · idempotent.


The problem

Claude Code runs on several surfaces — the terminal CLI, the VS Code extension, and the native Desktop app. They share your transcripts on disk, but each surface keeps its own session list. Open the Desktop app and your CLI/VS Code history is nowhere to be found.

There's a built-in handoff (/desktop), but it isn't available on every install — so for a lot of people there's no built-in way to do this at all.

What it does

It resurfaces your existing sessions in Desktop. Run it, and every CLI/VS Code session shows up in the Desktop list after you restart the app. It only ever adds — it never edits or deletes a transcript.

How it works (30 seconds)

  • Claude Code stores full transcripts as JSONL under ~/.claude/projects/… — shared by the CLI and the VS Code extension.
  • The Desktop app lists sessions via tiny pointer records that reference a transcript by id (it doesn't copy the conversation).
  • claude-resurface generates those pointer records for transcripts that don't have one yet, cloning the schema from a session Desktop already knows.
  • Quit and reopen Desktop, and they're all in the list.

It's the same idea as the built-in /desktop handoff — done by hand, so it works even where that handoff isn't available.

Requirements

  • macOS (where the Desktop app stores sessions this way)
  • The Claude Desktop app, opened in Code mode at least once
  • python3 (ships with macOS)

Install

In a Claude Desktop chat:

install the skill from https://github.com/TokenTyrant/claude-resurface

…or clone it yourself:

git clone https://github.com/TokenTyrant/claude-resurface ~/.claude/skills/claude-resurface

Then start a new chat — skills load at session start.

Use

Just ask:

resurface my CLI sessions in Desktop

Claude will:

  1. Dry-run first and show the plan — which sessions, which projects.
  2. Warn about live sessions still open in a terminal (don't open those in Desktop until you close them, or two processes fight over the transcript).
  3. Offer to extend retention — Claude Code prunes transcripts after cleanupPeriodDays (default 30), which would orphan the new pointers. It asks before changing anything.
  4. Create the pointers and archive your transcripts.

Then quit Claude Desktop (⌘Q) and relaunch — your sessions are now in the list. (They will not appear until you restart the app; pointers are read at startup.)

Safe by design

  • Never destructive — only writes pointer records + archive copies; never edits or deletes a transcript.
  • Idempotent — re-runs skip anything already imported (dedup by session id).
  • Archived — transcripts are copied to ~/.claude/session-archive/, so the import survives a Desktop re-index and nothing is lost to pruning.
  • Undo — --undo removes only the pointers it created (tracked in a manifest).
  • Live-session aware — flags sessions currently open so you don't corrupt an active transcript.

Caveats

  • The Desktop session-pointer format is undocumented and may change between Desktop releases. If imports stop appearing after an update, inspect a freshly created Desktop session record under ~/Library/Application Support/Claude/claude-code-sessions/… and update the field mapping in the script — your archived transcripts mean a re-run fixes it.
  • VS Code sessions live in the same store as the CLI, so they're covered too.
  • Not affiliated with Anthropic.

Advanced: direct CLI

You don't need to invoke the script yourself — the skill drives it — but it's a plain Python script if you prefer:

python3 ~/.claude/skills/claude-resurface/scripts/import_sessions.py --dry-run        # preview, write nothing
python3 ~/.claude/skills/claude-resurface/scripts/import_sessions.py                   # import all
python3 ~/.claude/skills/claude-resurface/scripts/import_sessions.py --project myrepo  # only sessions whose cwd matches
python3 ~/.claude/skills/claude-resurface/scripts/import_sessions.py --set-retention 3650  # bump cleanupPeriodDays
python3 ~/.claude/skills/claude-resurface/scripts/import_sessions.py --undo            # remove pointers it created

License

MIT

Ver o original no GitHub

Bom para

Relacionados