PortliftGet started
Menu
Browse the guides
PORTLIFT / First migration

OpenClaw → Codex. One move, reviewed.

Follow the Release Notes example from the homepage: preview three destination files, approve the move, then restore the original instructions.

OPENCLAWCODEXMerge mode

1. Start with the Release Notes agent

Use a disposable OpenClaw agent or a copy of your own for the first walkthrough. The example carries the instruction “Summarize changes in three bullets.” and a release-summary skill into Codex.

Install Portlift, run portlift ui, and open the local session link. Scan this machine or choose the OpenClaw folder. Select the agent and Save agent to keep a library version.

2. Preview the destination files

Select Codex and the destination folder, then choose Merge. The homepage fixture produces the changes below; your preview depends on your agent and the files already at its destination.

Release Notes example · destination changes
FileActionPurpose
AGENTS.mdUpdateMerge the instructions with the existing project guidance.
.codex/skills/release-summary/SKILL.mdCreateWrite the compatible release-summary skill.
.codex/config.tomlCreateWrite supported configuration for this fixture.
AGENTS.md / EXAMPLE ADDED LINES
+Summarize changes in three bullets.
+- Use plain language.

Preview does not write these destination changes. Open the diffs, inspect every path, and read the compatibility and permission notes.

3. Approve and apply

Apply only the preview you reviewed. If required, explicitly approve replacement, overwriting previously modified files, broader permissions, or configured commands. A destination file that changes after the preview requires a fresh preview.

Portlift records the original state of the files it is about to change. After applying, read the receipt and open the destination in Codex to check the result. Keep manual setup items from the report.

4. Preview a restore

Open the migration receipt in Activity, or the agent’s Backups, and choose Preview restore. In this example, the original AGENTS.md contents return. Newly created files are removed only if they still match Portlift’s recorded write; edited new files are skipped.

Review the restore diff before choosing Restore files. Restoring an existing file can replace edits made since the migration. Portlift first saves a safety backup of the files affected by the restore.

Verify the round trip.

The release smoke test checks that an OpenClaw → Codex preview leaves the destination untouched, the approved migration carries the instructions, and restore returns the original bytes. It uses disposable fixtures.

Continue to backup and recovery →