cameron.stream / note
[READ-ONLY] Mirror of https://github.com/just-cameron/note. External storage tool for Letta agents to manage persistent notes
0
Fork 0

Configure Feed

Select the types of activity you want to include in your feed.

6 3 0

Clone this repository

https://git.vm.fail/cameron.stream/note https://git.vm.fail/did:plc:j3a7ypiugdazlwnpdpc5lyqz
ssh://git@knot1.tangled.sh:2222/cameron.stream/note ssh://git@knot1.tangled.sh:2222/did:plc:j3a7ypiugdazlwnpdpc5lyqz

For self-hosted knots, clone URLs may differ based on your setup.


Download tar.gz Download .zip
README.md

Vault Tool for Letta Agents#

External storage tool for Letta agents to manage persistent vault items with attach/detach semantics.

Note: This branch uses tags-based ownership which requires an updated Letta client with block tags support.

Installation#

Register the tool with your Letta agent:

python create_vault_tool.py

Commands#

Command Description
create <path> <content> Create new item (not attached)
view <path> Read item contents
attach <path> [content] Load into context (supports /folder/*)
detach <path> Remove from context (supports /folder/*)
insert <path> <content> [line] Insert before line (0-indexed)
append <path> <content> Add content to end
replace <path> <old_str> <new_str> Find/replace with diff
rename <path> <new_path> Move/rename item
copy <path> <new_path> Duplicate item
delete <path> Permanently remove
list [query] List items (prefix filter, * for all)
search <query> [label|content] Search by label or content
attached Show items in context

Features#

  • Agent-scoped storage - Each agent's items are isolated via tags
  • Attach/detach semantics - Load items into context or remove them
  • Path-based organization - Organize with paths like /projects/webapp
  • Bulk operations - Support for wildcards like attach /folder/*
  • Auto-maintained directory - A /vault_directory block shows all items

Command Permissions#

By default, all commands are enabled. You can restrict which commands are available by setting the ENABLED_COMMANDS environment variable on your Letta server:

# Enable all commands (default)
ENABLED_COMMANDS="all"

# Disable delete (safer for production)
ENABLED_COMMANDS="create,view,attach,detach,insert,append,replace,rename,copy,list,search,attached"

# Read-only mode
ENABLED_COMMANDS="view,list,search,attached"

Disabled commands will return an error message listing which commands are enabled.

License#

MIT