Memory & Notes — Hamster AI

Memory Types

Type	What it stores	Command
Memories	General facts and preferences	`/remember`
To-dos	Tasks to complete	`/todo`
Notes	Freeform notes	`/note`
Feature backlog	Unsupported things you asked for	`/add-feature`
Preferences	Inferred long-term habits (asked before saving)	Conversational

Commands

/remember <text>Save a memory. Example: /remember I prefer short answers

/todo <task>Add a to-do. Example: /todo buy batteries tomorrow

/note <text>Save a note. Example: /note hotel checkout is 11am

/show-memoriesList all saved memories

/show-todosList all to-dos

/show-notesList all notes

/search-memory <term>Search across all memories, todos, and notes

/show-featuresShow the future feature backlog

/add-feature <text>Add an item to the feature backlog

Preference Detection

If Hamster AI notices a possible long-term preference during conversation, it asks before saving:

Noted for this chat. Want me to remember that as a general preference?

It will never silently save inferred preferences.

Reminders

Reminders are handled by the Scheduled Reminders plugin (enabled by default). They use natural language:

/remind me at 6pm to check the build
/remind me in 30 minutes to take a break
/remind me tomorrow at 9am about the meeting

Reminders fire as desktop notifications. During protected modes (Work, Private, Focus, Game Safe) they can be queued and delivered when the mode ends.

Storage

Everything is stored in a local SQLite database at data/hamster_ai.db. No data leaves your machine.

To wipe all data Delete data/hamster_ai.db. The app will recreate an empty database on next launch. This cannot be undone.

Clearing Data

You can clear specific data without deleting the whole database using Forget Mode commands:

/forget-todayClear today's session data and activity logs

/forget-last-hourClear the last hour of activity

/forget-sessionClear the current session

/clear-activityClear all activity logs