Add system-tools: shell execution, file ops, directory listing

[dmoskov]

Summary

Adds four system interaction tools that extend Letta's built-in capabilities:

Tool	What it does	Why needed
execute_shell_command	Run shell commands with timeout	Letta has no shell execution
read_file_contents	Read files without limits	Letta's read_from_text_file has 500 char limit
write_file_contents	Overwrite files	Letta's append_to_text_file only appends
list_directory_contents	List directory contents	Letta has no equivalent

Files

• SKILL.md - Full documentation with examples
• scripts/system_tools.py - Tool implementations
• scripts/register_system_tools.py - Registration script
• references/COMPARISON.md - Comparison with Letta built-ins

Usage

python scripts/register_system_tools.py --server http://localhost:8283

Or via SDK:

from letta import create_client
from system_tools import TOOLS

client = create_client(base_url="http://localhost:8283")
for tool_name, tool_def in TOOLS.items():
    client.create_tool(func=tool_def["func"], name=tool_name)

Security Note

execute_shell_command is intentionally not in Letta's built-ins for security in multi-tenant environments. These tools are designed for trusted, single-tenant deployments.

Test Plan

• All tools tested locally with success/error cases
• Timeout handling verified
• Error messages are clear and actionable
• Registration script syntax verified

---

🤖 Generated with Claude Code

[cpfiffer]

Hey @letta-code could you take a look please?

[github-actions]

Letta Code encountered an error —— View job

Failed with exit code 128

---

The agent encountered an issue before updating the comment.