How to use day-to-day

You do not need to ask OpenCode to “remember” things for the plugin to work. With the defaults, memory builds up as you work.

Typical daily flow

1. Enable the plugin (see Getting Started) and restart OpenCode.
2. Configure an AI provider for auto-capture — recommended: opencodeProvider + opencodeModel (or "opencodeModel": "inherit"). Details under Auto-Capture AI Provider.
3. Work normally in OpenCode. When a session goes idle, auto-capture extracts memorable technical context and stores it.
4. In later sessions, relevant memories are injected into context (see chatMessage / compaction settings). Browse or edit them in the web UI at http://127.0.0.1:4747.
5. Use the memory tool when you want something stored or retrieved immediately (see Usage Examples).

Automatic vs manual memory

Approach	When it runs	What you do
Auto-capture (autoCaptureEnabled: true, default)	After conversation turns when the session goes idle	Nothing — extraction is automatic
Manual memory tool / commands	On demand	add, search, list, profile, forget, list-shards, migrate, export, import

Manual search/add/list still work even if auto-capture has no provider configured. Auto-capture and user profile learning need a provider that can return structured/tool-call output.