用途：作为本地 mod 斜杠命令的专用入口，指导创建、编辑与启用 Letta Code mod 提供的 /command。若涉及更广泛的 mod 工作，相关配方位于 ../creating-mods/references/ 下的 commands.md、architecture.md、ui.md 与 plan-mode.md。
主要能力：先判断用户需求该做成哪种形式——/foo 发送提示或显示本地输出时用 mod 命令；启动可复用智能体工作流时用 skill 加轻量 mod 命令；需要智能体自主调用能力时用 mod tool 而非命令；需要瞬时进度或结果时用 mod 命令加面板；主智能体繁忙时仍需模型输出，则用 runWhenBusy: true 命令加 forked ctx.conversation。若命令属于持久工作流（如 /goal），把工作流指令放进 skill，mod 命令仅作小型启动器或提示。
使用方式：mod 文件位于 ~/.letta/mods/，建议使用聚焦的文件名，例如 ~/.letta/mods/review.ts 或 ~/.letta/mods/commands.ts。用 letta.commands.register() 注册，并以 letta.capabilities.commands 做能力守卫；返回注销函数，或返回一个调用注销并清理定时器/面板的 disposer。命令结果有三种类型：prompt（把内容发给智能体，用于普通斜杠快捷方式）、output（打印本地文本、不联系智能体）、handled（命令自行处理副作用或 UI，面板命令常见）。资料给出默认 prompt 命令的 TypeScript 示例：导出 activate(letta) 函数，检查 letta.capabilities.commands，然后注册 id、description、args 与 run(ctx)，run 返回带 content 和 systemReminder 的 prompt 对象。
规则与限制：命令 ID 省略斜杠，写 "review" 而非 "/review"；使用字母、数字与连字符组成的小写 slug；不要注册内置命令 ID；runWhenBusy: true 的命令在主智能体繁忙时不得返回 prompt，应使用 scoped conversation 辅助方法或面板并返回 handled；showInTranscript: false 的命令通常应返回 handled 而非 prompt；不要导入 Letta Code 应用内部模块；不要在启动时做意外副作用，mod 会在应用启动和 /reload 时激活。完成后需告知用户确切改动的文件路径，并让其运行 /reload。
适用场景：为 Letta Code 添加自定义 /command、斜杠命令、命令快捷方式或作用域命令等。限制：资料未提供收费、价格、平台与效果等信息。