Fimeg/letta-code
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs: Document /link and /unlink commands (#74)

Browse Source 
Co-authored-by: Letta <noreply@letta.com>
This commit is contained in:
Cameron
2025-11-06 12:10:37 -08:00
committed by GitHub
parent 50e590e70f
commit a9d2747710
1 changed files with 34 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
README.md
View File

@@ -86,10 +86,44 @@ letta --agent <id> # Use specific agent ID
letta --model <model> # Specify model (e.g., claude-sonnet-4.5, gpt-4o)
letta -m <model> # Short form of --model
letta --continue # Resume global last agent (deprecated, use project-based)
# Managing tools (requires --agent flag)
letta --agent <id> --link # Attach Letta Code tools to agent, then start session
letta --agent <id> --unlink # Remove Letta Code tools from agent, then start session
```
> **Note:** The `--model` flag is inconsistent when resuming sessions. We recommend using the `/model` command instead to change models in interactive mode.
#### Interactive Commands
While in a session, you can use these commands:
- `/agent` - Show current agent link
- `/model` - Switch models
- `/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
- `/clear` - Clear conversation history
- `/exit` - Exit and show session stats
- `/logout` - Clear credentials and exit
#### 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:
**Via CLI flags** (before starting session):
```bash
letta --agent <id> --link # Attach Letta Code tools
letta --agent <id> --unlink # Remove Letta Code tools
```
**Via interactive commands** (during session):
```bash
/link # Attach Letta Code tools to current agent
/unlink # Remove Letta Code tools from current agent
```
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).
### Headless Mode
```bash
letta -p "Run bun lint and correct errors" # Auto-resumes project agent