migrate-memory

Migrate an agent group's durable memory between provider stores.

Updated May 7, 2026
One-click install
npx skills add https://github.com/Bartunek/nanoclaw --skill migrate-memory-bartunek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-memory
Source: https://github.com/Bartunek/nanoclaw/tree/main/.claude/skills/migrate-memory
Command: npx skills add https://github.com/Bartunek/nanoclaw --skill migrate-memory-bartunek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Carry an agent group's memory across a provider switch, in either direction (e.g. Claude ↔ Codex, or any provider to/from another). Run after the operator switches a group's provider with ncl groups config update --provider. The coding agent reads the source provider's memory store, distills it into the target provider's store, and restarts the group. Triggers on "migrate memory", "carry memory over", "the agent forgot everything after the switch".

Core Features & Use Cases

  • Reads the source memory store and distills durable content into the target store.
  • Supports both memory shapes: flat (CLAUDE.local.md) and scaffold tree (memory/).
  • Restarts the group after successful migration to ensure continuity of behavior. Examples include migrating from Claude to Codex or vice versa while preserving agent identity and configurations.

Quick Start

Execute the memory migration for the selected group after confirming the source and target providers.

Frequently Asked Questions about migrate-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate agent memory after switching providers?

To migrate agent memory after a provider switch, run the memory migration tool after updating the group's provider configuration. It reads the source memory store, distills durable content, writes to the target store, and restarts the group to ensure behavioral continuity.

Why does my agent forget everything after a provider switch?

An agent forgets everything after a provider switch because the durable memory remains stored in the previous provider's memory store. Memory migration transfers this identity and configuration data from the source store to the new target store.

Does memory migration support both flat and scaffold memory representations?

Memory migration supports both flat memory representations like CLAUDE.local.md and scaffold tree structures within a memory directory. It reads the source provider's memory shape and distills the durable content directly into the target provider's store.

Can I carry memory over between Claude and Codex providers?

You can carry memory over between Claude and Codex providers in either direction. The migration tool reads the source provider's memory store, infers the durable content, and writes it to the target provider's store before restarting the group.

What is the best way to preserve agent identity when changing providers?

The best way to preserve agent identity when changing providers is to execute a memory migration for the selected group. This distills durable content such as preferences and configurations from the source store into the target store, maintaining continuity.

Do I need to update the group provider config before migrating memory?

You need to update the group provider configuration before migrating memory. The memory migration process is designed to run after the operator switches a group's provider, reading the old source store and writing to the newly configured target store.