Remember My Stuff
Use this skill when the user asks to remember item-related facts or find stored facts. It uses a remote NocoDB database to store item names plus flexible content such as locations, dates, birthdays, features, events, reminders, or notes.
Portability
This skill is installable on any machine.
- NocoDB connection details are read from environment variables or CLI flags.
- No local machine paths are required.
- The script defaults to the current working directory when it needs a scratch
tmp/folder.
Script Location
skills/remember/scripts/manage_items.py
Configuration
Set these environment variables when running on a new machine:
REMEMBER_NOCODB_URLREMEMBER_NOCODB_API_TOKENREMEMBER_NOCODB_TABLE_IDREMEMBER_WORKSPACEoptional, used only for image downloads
You can also pass the same values with command-line flags:
--url--token--table-id
Usage
1. Remember an Item
User: "Remember my watch is in the study, white cabinet, 3rd drawer." (or uploads an image and says "Remember this is my watch")
Action:
python3 skills/remember/scripts/manage_items.py add "watch" "study, white cabinet, 3rd drawer" --type "location" --image "/path/to/image.jpg"
python3 skills/remember/scripts/manage_items.py add "mom's birthday" "June 3" --type "date"
python3 skills/remember/scripts/manage_items.py add "charger" "black cable, USB-C, 2m" --type "feature"
python3 skills/remember/scripts/manage_items.py add "meeting" "tomorrow 10:00" --type "event"
After the add command succeeds, confirm that you used the /remember tool, then run list so the user can verify.
2. Find an Item
User: "Where is my watch?" / "When is mom's birthday?" / "What is the feature of my charger?" / "Remind me about tomorrow's meeting."
Action:
python3 skills/remember/scripts/manage_items.py find "watch"
python3 skills/remember/scripts/manage_items.py find "birthday"
python3 skills/remember/scripts/manage_items.py find "charger"
python3 skills/remember/scripts/manage_items.py find "meeting"
Output:
- The script prints the matched content and image path if it exists.
- If the record contains an image, the script downloads it to
tmp/under the active workspace or current directory.
Reply after find:
- Tell the user the matched fact.
- If the fact is a location, say that clearly.
- If the fact is a birthday, date, feature, or event, say that clearly too.
- Provide the local image path if available.
3. Update an Item
User: "I moved my watch to the bedroom." / "My mom's birthday is June 4 now." / "The charger is now the black one."
Action:
- Find the item to get its ID:
python3 ... find "watch" - Update the content and optionally add/change image:
python3 skills/remember/scripts/manage_items.py update <ID> --content "bedroom" --type "location" --image "/path/to/new_image.jpg"
python3 skills/remember/scripts/manage_items.py update <ID> --content "June 4" --type "date"
python3 skills/remember/scripts/manage_items.py update <ID> --content "black one" --type "feature"
4. List All Items
User: "What items have you remembered?"
Action:
python3 skills/remember/scripts/manage_items.py list
5. Delete an Item
User: "Forget about the old watch."
Action:
- Find the item first to get its ID:
python3 ... find "watch" - Delete by ID:
python3 skills/remember/scripts/manage_items.py delete <ID>
Tips
- When searching, the script uses fuzzy matching for item name, content, type, and note.
- If the user asks "Where is X?", try
find X. - If the user asks about birthdays, dates, features, or events, still use
findwith the key fact as the query. - This database is shared with the user's NocoDB interface.
- 图片自动下载后会保存在
tmp/目录。 - 找到多条记录时,先列候选项,再按需逐条处理。
- The script uses
REMEMBER_-prefixed environment variables first, then CLI flags, and finally safe defaults where possible.
Schema
The table structure is documented in skills/remember/scripts/schema.sql.