@letta-ai/letta-code 0.5.1 → 0.5.2

package/README.md

@@ -166,17 +166,82 @@ letta --agent <id> --unlink    # Remove Letta Code tools from agent, then start
 #### Interactive Commands
 
 While in a session, you can use these commands:
+
+**Agent Management:**
 - `/agent` - Show current agent link
-- `/model` - Switch models
-- `/toolset` - Switch toolsets (codex/default)
+- `/swap` - Switch to a different agent (prompts with agent selector)
 - `/rename` - Rename the current agent
+- `/download` - Download agent file locally (exports agent configuration as JSON)
+
+**Configuration:**
+- `/model` - Switch models (prompts with model selector)
+- `/toolset` - Switch toolsets (codex/default/gemini)
+- `/system` - Switch system prompt (change agent behavior preset)
 - `/stream` - Toggle token streaming on/off
+
+**Tools & Memory:**
 - `/link` - Attach Letta Code tools to current agent (enables Read, Write, Edit, Bash, etc.)
 - `/unlink` - Remove Letta Code tools from current agent
+- `/init` - Initialize agent memory for this project (guides agent to organize memory blocks based on current context)
+
+**Skills:**
+- `/skill` - Enter skill creation mode (optionally: `/skill <description>`)
+
+**Background Processes:**
+- `/bashes` - Show background shell processes (displays shells started with `run_in_background=true`)
+
+**Session Management:**
 - `/clear` - Clear conversation history
 - `/exit` - Exit and show session stats
 - `/logout` - Clear credentials and exit
 
+#### Background Shell Processes
+
+When running long-running commands (like dev servers, test watchers, or builds), the agent can use `run_in_background=true` with the Bash tool. Use `/bashes` to view all background processes:
+
+```bash
+/bashes     # Shows running background shells with their IDs and commands
+```
+
+The agent can monitor background process output using the `BashOutput` tool and terminate them with `KillBash`.
+
+#### Memory Initialization
+
+The `/init` command helps the agent organize its memory blocks based on your project context:
+
+```bash
+/init       # Guides agent to analyze project and structure its memory
+```
+
+This is useful when:
+- Starting fresh in a new project
+- Reorganizing an existing agent's memory structure
+- After sharing project documentation (like AGENTS.md or README)
+
+The agent will analyze available context and create/update memory blocks like:
+- **`project`** - Build commands, architecture, conventions
+- **`human`** - Your coding preferences and communication style  
+- **`ticket`/`context`** - Current task or debugging context
+
+See [Memory Configuration](#memory-configuration) for more details on memory blocks.
+
+#### Skill Creation
+
+The `/skill` command enters an interactive mode for creating new skills:
+
+```bash
+/skill                          # Enter skill creation mode
+/skill "Python testing helper"  # Start with a description
+```
+
+Skills are modular packages that extend Letta Code with specialized knowledge or workflows. The agent will guide you through:
+1. Defining the skill's purpose and scope
+2. Creating the skill structure (SKILL.md + optional resources)
+3. Writing effective instructions and bundled scripts
+4. Validating and packaging the skill
+
+Created skills are saved to your `.skills` directory and automatically discovered on next session.
+
 #### Managing Letta Code Tools
 
 Letta Code provides tools like `Bash`, `Read`, `Write`, `Edit`, `Grep`, `Glob`, and more. You can attach or remove these tools from any agent:
@@ -328,6 +393,28 @@ Permissions are also configured in `.letta/settings.json`:
 }
 ```
 
+## Updates
+
+Letta Code automatically checks for updates on startup and installs them in the background.
+
+### Auto updates
+
+* **Update checks**: Performed on startup
+* **Update process**: Downloads and installs automatically in the background  
+* **Applying updates**: Updates take effect the next time you start Letta Code
+
+**Disable auto-updates:**
+Set the `DISABLE_AUTOUPDATER` environment variable in your shell:
+```bash
+export DISABLE_AUTOUPDATER=1
+```
+
+### Update manually
+
+```bash
+letta update
+```
+
 ## Self-hosting
 
 To use Letta Code with a self-hosted server, set `LETTA_BASE_URL` to your server IP, e.g. `export LETTA_BASE_URL="http://localhost:8283"`.