$note

Overview

$note saves a note to the current session. Jot down a decision, your progress, or the bit of temporary context you'll want back in an hour. Within that same session, other agents can read what you saved.

Example

$note "auth refactor confirmed to use JWT approach"
$note "users table migration currently on hold"
$note

Running without arguments prints the list of saved notes.

When to use

• When you don't want to lose a mid-session decision during a long session
• When you need to leave context to share between agents during $ralph or $team runs
• When you need a temporary note to come back to later

When to avoid

• Content that needs to be permanent — session notes are session-scoped. For long-term records, write to .omx/notepad.md or project documentation.
• Code changes — modify the actual files rather than leaving a note.

Related

• State and sessions — how OMX manages session context