PortliftGet started
Menu
Browse the guides
PORTLIFT / CLI

Portlift, from your terminal.

Use the same local library as the dashboard. Inspect first, then review the preview before changing destination files.

Find the commands you need

TERMINAL
portlift --help
portlift cli --help
portlift cli adapters
portlift cli scan
portlift cli --json list

The CLI delegates migration commands to the bundled Nomad engine, so help may say “nomad.” Run these commands through portlift cli to use Portlift’s selected library.

Plan a migration

TERMINAL
portlift cli migrate --help
portlift cli move --help

Use the command help to choose a source, destination, and mode. Review the preview and required approvals. For the full file-by-file example, follow OpenClaw → Codex.

Inspect packages and history

TERMINAL
portlift cli validate ./agent.nomad
portlift cli history
portlift cli backups
portlift cli keys

Replace ./agent.nomad with your package path. Use the agent, operation, and backup identifiers returned by the CLI when requesting details.

Backups and restores

TERMINAL
portlift cli backup --help
portlift cli restore --help
portlift cli restore-version --help

A file restore and a saved-version restore affect different things. Read Backup & recovery before proceeding.

Choose the same library

TERMINAL
portlift --home /absolute/path/to/library ui
portlift --home /absolute/path/to/library cli list

Put --home before the subcommand. You can also set PORTLIFT_DATA_DIR in the environment of the dashboard, CLI, and MCP client. New installations default to ~/.portlift; an existing legacy ~/.agent-studio library may be reused.