CLI 参考
Letta Code 的命令行选项和标志
基本用法
letta [options] [-p "prompt"]会话标志
| 标志 | 描述 |
|---|---|
letta | 恢复与上次使用的代理的默认对话 |
letta --new | 开始新对话（用于并发会话） |
letta --continue, -c | 完全恢复上次会话（相同代理 + 对话） |
letta --resume, -r | 打开对话选择器以浏览和恢复过去的会话 |
letta --conversation <id>, --conv | 通过 ID 恢复特定对话 |
letta --default | 使用代理的默认对话（需要 --agent 或 --name） |
letta -n "Name" --default | 通过名称使用代理的默认对话 |
letta --conv default --agent <id> | 同上（显式形式） |
letta --conv <agent-id> | 简写：使用指定代理的默认对话 |
letta --new-agent | 强制创建新代理 |
letta --from-af <path> | 从 AgentFile (.af) 创建新代理 |
letta --agent <id>, -a | 通过 ID 使用特定代理 |
letta --name <name>, -n | 通过名称恢复代理（匹配固定或最近的代理） |
letta --info | 显示项目信息、技能目录和固定代理（不启动会话） |
letta --help | 显示帮助 |
letta --version | 显示版本 |
模型和配置
| 标志 | 描述 |
|---|---|
--model <model>, -m | 指定模型（例如 sonnet-4.5、gpt-5-codex） |
--system <preset> | 使用系统提示预设（例如 letta-claude、codex） |
--system-custom <text> | 使用自定义系统提示字符串（用于新代理） |
--system-append <text> | 将文本附加到解析的系统提示（用于新代理） |
--toolset <name> | 强制工具集：default、codex 或 gemini |
--skills <path> | 自定义技能目录 |
--sleeptime | 启用睡眠时间记忆管理（仅用于新代理） |
注意：恢复会话时，--model 标志可能不一致。在交互会话期间使用 /model 命令来更改模型。
注意：当使用 --agent <id> 连接到现有代理时，代理的现有配置（模型、工具集）会被保留。在会话期间使用 /model 或 /toolset 来更改它们。
无头模式
非交互式运行 Letta Code，用于自动化和 CI/CD。详细用法请参阅 无头模式。
| 标志 | 描述 |
|---|---|
-p "prompt" | 运行一次性提示（无头模式） |
--output-format <fmt> | 输出格式：text、json 或 stream-json |
--input-format <fmt> | 输入格式：stream-json 用于双向模式 |
--yolo | 绕过所有权限提示 |
--permission-mode <mode> | 设置权限模式 |
--tools "Tool1,Tool2" | 限制可用工具 |
--allowedTools "..." | 允许特定工具模式 |
--disallowedTools "..." | 阻止特定工具模式 |
记忆配置
创建新代理时配置记忆块。
| 标志 | 描述 |
|---|---|
--init-blocks <names> | 逗号分隔的预设块名称（例如 "persona,project"） |
--memory-blocks <json> | 自定义记忆块的 JSON 数组 |
--block-value <label>=<value> | 设置预设块的值（可多次指定） |
维护
| 标志 | 描述 |
|---|---|
letta update | 手动检查并安装更新 |
环境变量
| 变量 | 描述 |
|---|---|
LETTA_API_KEY | 用于认证的 API 密钥（在 app.letta.com/api-keys 获取） |
LETTA_BASE_URL | 自托管 Letta 服务器的基础 URL（例如 http://localhost:8283） |
LETTA_DEBUG | 设置为 1 启用调试日志 |
LETTA_CODE_TELEM | 设置为 0 禁用匿名遥测 |
DISABLE_AUTOUPDATER | 设置为 1 禁用自动更新 |
在您的 shell 配置文件（~/.bashrc、~/.zshrc）或 .env 文件中设置这些：
export LETTA_API_KEY="your-key-here"
export LETTA_BASE_URL="http://localhost:8283"键盘快捷键
这些快捷键在交互会话期间有效。
| 快捷键 | 描述 |
|---|---|
/ | 打开命令自动完成 |
@ | 打开文件自动完成 |
! | 进入 bash 模式（直接运行 shell 命令） |
Tab | 自动完成命令或文件路径 |
Shift+Enter | 插入换行（多行输入） |
↑/↓ | 导航历史或菜单项 |
Esc | 取消对话框或清除输入（双击） |
Ctrl+C | 中断操作或退出（双击） |
Ctrl+V | 粘贴内容或图片 |
Bash 模式让您直接运行 shell 命令，无需涉及代理。在空输入行上按 ! 进入 bash 模式（提示符变为 !），输入您的命令，然后按 Enter。在空行上按 Backspace 退出 bash 模式。