CLI Commands Quick Reference

Fresh

Core Commands

Command	Description
letta	Start interactive mode
letta -p "query"	One-shot headless query
letta server	Start server (for cloud/channels/scheduling)
letta --version	Show version

Interactive Commands

Command	Description
/init	Initialize agent memory
/memory	Manage memory blocks
/search	Search past messages
/remember	Direct agent to store information
/doctor	Audit and refine memory structure
/sleeptime	Configure reflection settings
shift-tab	Toggle between modes

Agent Management

Command	Description
letta -p "query" --new	New conversation
letta -p "query" --new-agent	New agent
letta -p "query" --agent <id>	Use specific agent
letta -p "query" --conversation <id>	Resume conversation
letta -p "query" -n "name"	Resume by agent name

Model Selection

Command	Description
--model sonnet	Use Sonnet model
--model auto	Auto-select model
-m gpt-5-codex	Specific model ID
--embedding letta/letta-free	Embedding model (new agents)

Permission and Tools

Command	Description
--yolo	Bypass prompts (except ExitPlanMode)
--tools "Read,Glob,Grep"	Restrict available tools
--permission-mode acceptEdits	Accept file edits automatically
--permission-mode plan	Require plan approval

Output Formats

Command	Description
--output-format text	Plain text (default)
--output-format json	Structured JSON with metadata
--output-format stream-json	Line-delimited JSON events
--include-partial-messages	Token-level streaming

System Prompt

Command	Description
--system letta-claude	Use preset prompt
--system letta-codex	Codex-optimized preset
--system letta-gemini	Gemini-optimized preset
--system-custom "prompt"	Custom system prompt

Channel Commands

Command	Description
letta channels configure telegram	Setup Telegram
letta channels configure slack	Setup Slack
letta channels route add --channel <ch> --chat-id <id> --agent <id>	Add route
letta channels route list	List routes
letta channels bind --channel slack --agent <id>	Bind Slack to agent
letta channels pair --channel telegram --code <code>	Pair Telegram user
letta server --channels telegram	Start with Telegram

Scheduling Commands

Command	Description
letta cron add --name "task" --prompt "msg" --cron "0 9 * * *" --agent <id>	Add cron task
letta cron add --name "task" --prompt "msg" --every 5m --agent <id>	Add interval task
letta cron add --name "task" --prompt "msg" --at "in 45m" --agent <id>	Add one-time task
letta cron list	List all tasks
letta cron list --agent <id>	List agent's tasks
letta cron get <id>	Get task details
letta cron delete <id>	Delete task

Advanced Flags

Command	Description
--toolset codex	Override toolset
--toolset gemini	Gemini toolset
--import ./my-agent.af	Import AgentFile
--import @author/agent-name	Import published agent
--init-blocks "persona,project"	Initialize memory blocks
--block-value "persona=..."	Set block value

SDK (npm)

# Install SDK
npm install @letta-ai/letta-code-sdk

# Install CLI globally
npm install -g @letta-ai/letta-code