@letta-ai/plan-mode
v0.1.1
Published
Letta Code mod package that adds plan mode.
Readme
Plan Mode
A Letta Code mod package that adds a plan-mode workflow using public mod APIs.
Plan mode pauses implementation, lets the agent gather read-only context, writes an implementation plan to ~/.letta/plans/, and asks the user to approve before coding starts.
Install
letta install npm:@letta-ai/plan-modeThen reload local mods:
/reloadWhat it adds
/planslash commandenter_plan_modemodel-callable toolexit_plan_modemodel-callable tool- a turn reminder while plan mode is active
- a permission overlay that blocks mutating tools except plan-file writes
Quick start
/planThe command tells the agent to explore read-only, write an implementation plan to a generated file under ~/.letta/plans/, present the full plan for approval, and then call exit_plan_mode after approval.
State files
This mod stores small local state in:
~/.letta/mods/plan-mode.state.jsonGenerated plan files live in:
~/.letta/plans/plan-*.mdSafety
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 lettaThen remove or edit the mod package and run /reload.
See MOD.md for the agent-facing behavioral contract and semantics.
