@letta-ai/letta-code 0.2.0 → 0.5.0

package/README.md

@@ -2,13 +2,13 @@
 
 A self-improving, stateful coding agent that can learn from experience and improve with use.
 
-https://github.com/user-attachments/assets/5561a3ff-afd9-42a9-8601-55d245946394
+<img width="1713" height="951" alt="letta-code" src="https://github.com/user-attachments/assets/ae546e96-368a-4a7b-9397-3963a35c8d6b" />
 
 ---
 
 ## What is Letta Code?
 
-Letta Code is a command-line harness around the stateful Letta [Agents API](https://docs.letta.com/api-reference/overview). You can use Letta Code to create and connect with any Letta agent (even non-coding agents!) - Letta Code simply gives your agents the ability to interact with your local dev environment, directly in your terminal.
+Letta Code is a command-line harness around the stateful [Letta API](https://docs.letta.com/api-reference/overview). You can use Letta Code to create and connect with any Letta agent (even non-coding agents!) - Letta Code simply gives your agents the ability to interact with your local dev environment, directly in your terminal.
 
 Letta Code is model agnostic, and supports Sonnet 4.5, GPT-5, Gemini 2.5, GLM-4.6, and more.
 
@@ -152,7 +152,7 @@ letta -p "Use the custom skills" --skills ~/my-skills
 letta                    # Auto-resume project agent (or create new if first time)
 letta --new              # Create new agent with new memory blocks
 letta --agent <id>       # Use specific agent ID
-letta --model <model>    # Specify model (e.g., claude-sonnet-4.5, gpt-4o)
+letta --model <model>    # Specify model (e.g., claude-opus-4.5, claude-sonnet-4.5, gpt-4o)
 letta -m <model>         # Short form of --model
 letta --continue         # Resume global last agent (deprecated, use project-based)
 
@@ -168,6 +168,8 @@ letta --agent <id> --unlink    # Remove Letta Code tools from agent, then start
 While in a session, you can use these commands:
 - `/agent` - Show current agent link
 - `/model` - Switch models
+- `/toolset` - Switch toolsets (codex/default)
+- `/rename` - Rename the current agent
 - `/stream` - Toggle token streaming on/off
 - `/link` - Attach Letta Code tools to current agent (enables Read, Write, Edit, Bash, etc.)
 - `/unlink` - Remove Letta Code tools from current agent
@@ -193,6 +195,36 @@ letta --agent <id> --unlink   # Remove Letta Code tools
 
 When you attach tools with `/link` or `--link`, they are added to the agent with approval rules enabled (human-in-the-loop). This means the agent can use these tools, but you'll be prompted to approve each tool call. Use permission modes to control approval behavior (see Permissions section below).
 
+### Toolsets
+
+Letta Code includes different toolsets optimized for different model providers:
+
+1. **Default Toolset** (Anthropic-optimized, best for Claude models)
+2. **Codex Toolset** (OpenAI-optimized, best for GPT models)
+3. **Gemini Toolset** (Google-optimized, best for Gemini models)
+
+**Automatic Selection:**
+When you specify a model, Letta Code automatically selects the appropriate toolset:
+```bash
+letta --model haiku           # Loads default toolset
+letta --model gpt-5-codex     # Loads codex toolset
+letta --model gemini-3-pro    # Loads gemini toolset
+```
+
+**Manual Override:**
+You can force a specific toolset regardless of model:
+```bash
+# CLI flag (at startup)
+letta --model haiku --toolset codex           # Use Codex-style tools with Claude Haiku
+letta --model gpt-5-codex --toolset gemini    # Use Gemini-style tools with GPT-5-Codex
+letta --toolset gemini                        # Use Gemini tools with default model
+
+# Interactive command (during session)
+/toolset                                      # Opens toolset selector
+```
+
+The `/model` command automatically switches toolsets when you change models. Use `/toolset` if you want to manually override the automatic selection.
+
 ### Headless Mode
 ```bash
 letta -p "Run bun lint and correct errors"              # Auto-resumes project agent