OpenSoul soul-note

Manage and access the independent Soul Note (self-reflection log), which automatically compresses daily discoveries and mood overviews.

install

source · Clone the upstream repo

git clone https://github.com/samttoo22-MewCat/OpenSoul

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/samttoo22-MewCat/OpenSoul "$T" && mkdir -p ~/.claude/skills && cp -r "$T/openclaw/skills/soul-note" ~/.claude/skills/samttoo22-mewcat-opensoul-soul-note && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/samttoo22-MewCat/OpenSoul "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/openclaw/skills/soul-note" ~/.openclaw/skills/samttoo22-mewcat-opensoul-soul-note && rm -rf "$T"

manifest: openclaw/skills/soul-note/SKILL.md

source content

Soul Note

This skill lets you (the agent) add quick notes, discoveries, memory updates, or reflections directly into the independent

soul_notes.json

log. The system automatically handles their aggregation into

soul_reflections.json

When to use

CRITICAL DISTINCTION: A

Soul Note

is your dynamic diary, event tracker, and daily reflection system. It is completely different from

SOUL.md

(which is your fixed, core personality configuration).

Use this

soul-note

skill ONLY when:

You discover a hidden truth, pattern, or interesting fact about the user that isn't simple enough for the procedural memory but doesn't warrant changing your core persona.
You want to drop a "bookmark," daily journal entry, or an internal dialogue note about your current emotional state.
The user asks you to log something to your soul diary, create a daily reflection, or write a "soul note".
DO NOT use this to alter your own personality traits or system rules (use
```
edit-soul
```
for that).

Quick start

To add a new note:

python scripts/soul_note_skill.py add "I just noticed the user prefers concise answers under stress." --category discovery --tags pattern,observation

Valid categories are:

reflection

discovery

error

memory_update

neurochemistry

To read today's notes:

python scripts/soul_note_skill.py today

To view recent major reflections:

python scripts/soul_note_skill.py list

Note: You must run the command from the root of the openSOUL project tree using the

exec

tool.