@letta-ai/letta-code 0.25.3 → 0.25.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@letta-ai/letta-code",
3
- "version": "0.25.3",
3
+ "version": "0.25.5",
4
4
  "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -64,7 +64,7 @@ Browse these repositories to discover available skills. Check the README for ski
64
64
 
65
65
  | Location | Path | When to Use |
66
66
  |----------|------|-------------|
67
- | **Agent-scoped** | `~/.letta/agents/<agent-id>/skills/<skill>/` | Skills for a single agent (default for agent-specific capabilities) |
67
+ | **Agent-scoped** | `~/.letta/agents/<agent-id>/memory/skills/<skill>/` | Skills for a single agent (default for agent-specific capabilities) |
68
68
  | **Global** | `~/.letta/skills/<skill>/` | General-purpose skills useful across projects |
69
69
  | **Project** | `.skills/<skill>/` | Project-specific skills |
70
70
 
@@ -82,7 +82,7 @@ git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
82
82
 
83
83
  # 2. Copy the skill to your skills directory
84
84
  # For agent-scoped (recommended default):
85
- cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
85
+ cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/memory/skills/
86
86
  # For global:
87
87
  # cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/skills/
88
88
  # For project:
@@ -96,13 +96,13 @@ rm -rf /tmp/skills-temp
96
96
 
97
97
  ```bash
98
98
  git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
99
- rsync -av /tmp/skills-temp/skills/webapp-testing/ ~/.letta/agents/<agent-id>/skills/webapp-testing/
99
+ rsync -av /tmp/skills-temp/skills/webapp-testing/ ~/.letta/agents/<agent-id>/memory/skills/webapp-testing/
100
100
  rm -rf /tmp/skills-temp
101
101
  ```
102
102
 
103
103
  ## Registering New Skills
104
104
 
105
- After downloading a skill, it will be automatically discovered on the next message. Skills are discovered from `~/.letta/skills/`, `.skills/`, and agent-scoped `~/.letta/agents/<agent-id>/skills/` directories.
105
+ After downloading a skill, it will be automatically discovered on the next message. Skills are discovered from `~/.letta/skills/`, `.skills/`, and agent-scoped `~/.letta/agents/<agent-id>/memory/skills/` directories.
106
106
 
107
107
  ## Complete Example
108
108
 
@@ -114,7 +114,7 @@ User asks: "Can you help me test my React app's UI?"
114
114
  4. **Download** (trusted source):
115
115
  ```bash
116
116
  git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
117
- cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
117
+ cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/memory/skills/
118
118
  rm -rf /tmp/skills-temp
119
119
  ```
120
120
  5. **Inspect scripts**: Read any .py or .ts files before using them
@@ -53,40 +53,11 @@ This is the recommended flow:
53
53
 
54
54
  This gives you full control over what you bring across and keeps everything consistent with memfs.
55
55
 
56
- ## Legacy Fallback (only if memfs is disabled)
56
+ ## If MemFS Is Disabled
57
57
 
58
- If memfs is **not enabled**, you can use block-level commands:
59
- - `letta blocks list`
60
- - `letta blocks copy`
61
- - `letta blocks attach`
58
+ The legacy block-level CLI commands have been removed. Enable MemFS first, then use the export → copy → sync workflow above.
62
59
 
63
- ⚠️ **Do not use these if memfs is enabled** they can diverge from file-based edits.
64
-
65
- ## Handling Duplicate Label Errors
66
-
67
- **You cannot have two blocks with the same label.** If you try to copy/attach a block and you already have one with that label, you'll get a `duplicate key value violates unique constraint` error.
68
-
69
- **Solutions:**
70
-
71
- 1. **Use `--label` (copy only):** Rename the block when copying:
72
- ```bash
73
- letta blocks copy --block-id <id> --label project-imported
74
- ```
75
-
76
- 2. **Use `--override` (copy or attach):** Automatically detach your existing block first:
77
- ```bash
78
- letta blocks copy --block-id <id> --override
79
- letta blocks attach --block-id <id> --override
80
- ```
81
- If the operation fails, the original block is automatically reattached.
82
-
83
- 3. **Manual detach first:** Use the `memory` tool to detach your existing block:
84
- ```
85
- memory(agent_state, "delete", path="/memories/<label>")
86
- ```
87
- Then run the copy/attach script.
88
-
89
- **Note:** `letta blocks attach` does NOT support `--label` because attached blocks keep their original label (they're shared, not copied).
60
+ If you run into duplicate filenames while copying memory files, rename the incoming file or merge its contents manually before committing.
90
61
 
91
62
  ## Workflow
92
63