@letta-ai/goal-mode
v0.1.0
Published
Example Letta Code mod package that adds goal mode with goal commands, tools, and turn reminders.
Readme
Goal Mode
A Letta Code mod package that adds a goal workflow using public mod APIs.
Goal mode keeps a user-provided objective active across turns. The agent receives reminders to continue toward the goal until it is completed, blocked, paused, or cleared.
Install
Once npm mod install support is available:
letta install npm:@letta-ai/goal-modeWhat it adds
/goalslash command for creating, inspecting, pausing, resuming, completing, and clearing goalsget_goal/GetGoalmodel-callable toolscreate_goal/CreateGoalmodel-callable toolsupdate_goal/UpdateGoalmodel-callable tools- turn reminders while an active goal is being pursued
Usage
/goal improve benchmark coverage
/goal --token-budget 50000 improve benchmark coverage
/goal status
/goal pause
/goal resume
/goal complete
/goal clearState files
This mod stores local state in:
~/.letta/mods/goal-mode.state.jsonSafety
Mods are trusted local code. Review the source before installing third-party mods.
If a mod breaks startup or command handling, recover with:
letta --no-mods
# or
LETTA_DISABLE_MODS=1 lettaNotes
This package is based on the goal-mode bundled-extension reference from Letta Code. It is implemented as a standalone mod package, so it stores state locally instead of importing Letta Code internals.
See MOD.md for the agent-facing behavioral contract.
