Episodic Diary

Find past chats in the episodic diary tier.

Skill metadata

Source	Bundled (installed by default)
Path	skills/memory/episodic-diary
Version	1.0.0
Author	VibeOS
License	MIT
Platforms	linux, macos, windows
Tags	memory, episodic, sessions, search
Related skills	progress-ledger

Reference: full SKILL.md

info

The following is the complete skill definition that VibeOS loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.

Episodic Diary Skill

Use the Episodic Memory OS tier when you need “what did we do about X?” — past sessions and messages — not short Core/User notes in the prompt.

When to Use

• User asks what you configured / decided last week (or earlier).
• Core/User memory is empty or too short; the answer lives in chat history.
• Narrow by project folder or time window before deep-diving a session.

Do not use this skill to dump whole transcripts into Core (MEMORY.md).

Prerequisites

• Session DB available for the active profile (SessionDB / FTS).
• Optional: session_search tool for in-chat scroll/read of a hit.

How to Run

# Recent sessions (browse)
vibeos memory episodes --limit 20

# Keyword search
vibeos memory episodes "Telegram" --since 7d

# Project cwd filter
vibeos memory episodes "deploy" --project ~/code/api --since 2w --json

Then open a hit with session_search (by session_id) or the desktop session picker.

Quick Reference

Need	Command / tool
List recent chats	vibeos memory episodes
FTS across messages	vibeos memory episodes "<query>"
Time window	--since 7d / 2w / ISO date
Project filter	--project <cwd-prefix>
In-agent read	session_search with session_id

Pitfalls

• Episodic is not injected into the system prompt — search explicitly.
• PII may appear in transcripts; do not copy secrets into Core/User.
• Profiles are isolated — episodes are per VIBEOS_HOME / profile.

Verification

• vibeos memory episodes Telegram --since 7d finds a setup chat when one exists.
• --json returns mode of search or browse with an episodes list.