| name | customizing-commands |
| description | Creates, edits, and enables Letta Code mod-provided slash commands. Use when the user asks to add a custom /command, slash command, command shortcut, scoped conversation-backed command, or command-driven panel behavior. |
Customizing Commands
Use this as the command-specific entrypoint for local mod slash commands. For broader mod work, recipes live in ../creating-mods/references/commands.md, ../creating-mods/references/architecture.md, ../creating-mods/references/ui.md, and ../creating-mods/references/plan-mode.md.
Mod files live in:
~/.letta/mods/
Use a focused file name, e.g. ~/.letta/mods/review.ts or ~/.letta/mods/commands.ts.
First decide whether a command is right
| User wants | Build |
|---|
/foo sends a prompt or shows local output | Mod command |
/foo starts a reusable agent workflow | Skill + thin mod command |
| Agent/model should autonomously call the capability | Mod tool, not a command |
| Command shows transient progress/results | Mod command + panel |
| Command needs model output while the main agent is busy | runWhenBusy: true command + forked ctx.conversation |
If the command is a durable workflow like /goal, put the workflow instructions in a skill and keep the mod command as a small launcher/prompt.
Workflow
- Inspect
~/.letta/mods/ for related command files.