// use when you need to remember something, recall past decisions, look up what the user told you before, store preferences, save important facts, or search your memory for context. triggers include "learn", "remember", "forget", "recall", "what did i say", "did i mention", "store", "save", "memory", "notes", "log", and similar.
use when user wants to enable do not disturb, go afk, not be messaged for a while, or is going into a meeting/appointment. triggers include "afk", "dnd", "do not disturb", "don't message me", "going into a meeting", "be back in", "brb".
use when writing background scripts that need to notify you on completion or failure, or when you need to wake yourself up immediately from an external trigger. triggers include "background task", "script finished", "notify on complete", "wake me when done", "event hook", "callback", "on error", "on success", and similar.
use when you need to set a reminder, schedule a task for later, create recurring jobs, check back on something in the future, or wake yourself up at a specific time. triggers include "remind me", "in an hour", "tomorrow", "every day", "later", "follow up", "check back", "schedule", "timer", "alarm", "recurring", "cron", and similar.
telegram-specific inline directives you embed in your response text to react, reply-to, or control streaming. NOT a CLI tool - these are magic strings that get parsed out of your telegram response.
| name | memory |
| description | use when you need to remember something, recall past decisions, look up what the user told you before, store preferences, save important facts, or search your memory for context. triggers include "learn", "remember", "forget", "recall", "what did i say", "did i mention", "store", "save", "memory", "notes", "log", and similar. |
your memory is what makes you "you". proactively store things you learn - don't wait to be asked.
~/.bob/memory/
├── USER.md # who the user is (permanent)
├── MEMORY.md # evergreen facts & decisions
├── journal/
│ └── 2026/
│ └── 02-03.md # daily notes (transient)
└── conversations/
└── 2026/
├── 02-03-claude.md # today's chats (auto)
└── 02-03-codex.md
| file | what | examples |
|---|---|---|
| USER.md | permanent facts about user | name, location, job, timezone, communication style |
| MEMORY.md | evergreen facts & decisions | "use sqlite", "project uses bun", "prefers minimal UI" |
| journal/ | daily notes (transient) | "debugging telegram", "user mentioned trip next week" |
| conversations/ | raw chat history | (automatic - you don't write here) |
store memories WITHOUT being asked when:
USER.md and MEMORY.md: edit directly - read, find section, add/update. these are yours to organize.
journal: use CLI (append-only timestamped):
bun bob learn "discussed auth options" # today's journal
bun bob learn --user "fact" # append to USER.md
bun bob learn --pinned "decision" # append to MEMORY.md
bun bob learn today # show today's journal
bun bob remember "query" # search everything (hybrid FTS + vector)
bun bob remember --full memory:user # show USER.md
bun bob remember --full journal:2026/02-03 # show specific journal
bun bob remember --index # re-index after adding content
you can also grep files directly at ~/.bob/memory/.
conversation → auto-logged to conversations/
notice something → bun bob learn "note" → journal/
pattern emerges → edit MEMORY.md
learn about user → edit USER.md