Import / Export

Export agents to files and import them back.

export agent

Export an agent's configuration to a file. Supports Letta-native JSON or git-trackable YAML formats.

lettactl export agent <name> [options]

Options

FlagTypeDescription
--format, -fjson | yaml = jsonExport format
--output, -ostringOutput file path
--legacy-formatbooleanUse legacy v1 export format
--skip-first-messagebooleanOmit first_message from YAML export
--max-stepsnumberLimit exported processing steps

Examples

Export as YAML
lettactl export agent my-agent -f yaml -o agent.yaml
Export as JSON
lettactl export agent my-agent -o backup.json

import

Import an agent from a previously exported file.

lettactl import <file> [options]

Options

FlagTypeDescription
--namestringOverride the agent name
--append-copybooleanAdd '_copy' suffix to avoid name conflicts
--embeddingstringOverride embedding model
--override-toolsbooleanOverwrite existing tool source code
--strip-messagesbooleanRemove message history from import
--secretsstringInject secrets as JSON
--env-varsstringInject environment variables as JSON

Examples

Basic import
lettactl import backup.json
Import with new name
lettactl import backup.json --name 'my-agent-v2'
Clean import
lettactl import backup.json --strip-messages --append-copy