Human-readable markdown session logs for characters and adventures.
Human-readable markdown session logs that tell stories
| K-Line | Why Related | |--------|-------------| | play-learn-lift/ | Sessions record PLAY | | plain-text/ | Sessions persist as text | | character/ | Session files live in character directories | | adventure/ | Adventure LOG.md follows session patterns | | summarize/ | Compress old sessions | | honest-forget/ | Graceful memory decay | | markdown/ | Sessions ARE markdown | | examples/adventure-4/characters/real-people/don-hopkins/sessions/ | Gold standard examples |
Quick Links:
Session logs are living documents that capture the narrative of play. Unlike technical event logs, sessions are meant to be READ — by users, by future LLMs warming context, by anyone exploring the repo.
[!NOTE] Session logs are NOT append-only! They grow and improve over time. Update the index, add links, fix typos — sessions are living documents.
Default: SESSION.md in the character directory, or named sessions in a sessions/ subdirectory.
characters/real-people/don-hopkins/sessions/marathon-session.md
characters/real-people/don-hopkins/sessions/adventure-uplift.md
characters/fictional/donna-toadstool/SESSION.md
characters/animals/monkey-palm/SESSION.md
Name variants: marathon-session.md, adventure-uplift.md, SESSION-day1.md
| Principle | Description | |-----------|-------------| | 📖 Narrative first | Write for humans, not machines | | 📂 Collapsible sections | Show narrative, hide data | | 📊 Index at top | Always keep updated | | 🔗 Link generously | Every file mentioned = link | | 📈 Tables tell stories | Stats, rosters, inventories | | 🔄 Retroactive improvement | Update as you learn more |
<details open>
<summary><h2>🌟 Major Event — Descriptive Subtitle</h2></summary>
Narrative content here (always visible).
<details open>
<summary>📂 <strong>Technical: YAML changes under the hood</strong></summary>
Hidden data — click to expand.
</details>
</details>
| Pattern | Use For | Default State |
|---------|---------|---------------|
| <details open> | Narrative chapters | Open |
| <details open> | Technical details | Closed |
Study these for best practices:
| Session | What It Demonstrates | |---------|---------------------| | Don Hopkins (Marathon) | 7000+ lines, 5 days, extensive linking, speed-of-light simulations | | Donna Toadstool | Character creation narrative, file operations, appendices |
| Direction | Destination | |-----------|-------------| | ⬆️ Up | skills/ | | 📖 Full Spec | SKILL.md |
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Use when you need to control Slack from OpenClaw via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
Manage Trello boards, lists, and cards via the Trello REST API.
Category:productivity
Tags:moollm, logging, narrative, persistence, history