/inbox - Oracle Inbox

Read and write timestamped notes to ψ/inbox/.

Usage

/inbox                    # List recent inbox items
/inbox read               # List recent inbox items (alias)
/inbox read <topic>       # Read specific item by topic keyword
/inbox write <topic>      # Write new inbox item
/inbox ls                 # List all items (full)
/inbox clean              # Archive old items (move to ψ/archive/inbox/)

Directory

ψ/inbox/
├── handoff/              # Session handoffs (managed by /forward)
├── schedule.md           # Schedule (managed by /schedule)
├── YYYY-MM-DD_HHMM_<topic>.md   # ← inbox items live here
└── ...

Filename Format

Every inbox item follows this pattern:

YYYYMMDD_HHMM_<topic-slug>_from_<sender>.md

Example: 20260323_2112_fix-auth-bug_from_peter.md

Rules:

• Date: compact YYYYMMDD (no dashes)
• Topic slug: lowercase, hyphens, no spaces
• Sender: who wrote it (oracle name or human name)
• Timestamp: local time (from date)
• Always at root of ψ/inbox/ (not in subdirectories)

---

Mode 1: Read (default)

/inbox or /inbox read

ROOT="$(pwd)"
INBOX="$ROOT/ψ/inbox"

List all .md files in ψ/inbox/ (excluding schedule.md and handoff/):

ls -1t "$INBOX"/*.md 2>/dev/null | grep -v schedule.md | head -10

is absolute (set as in Mode 1 Step 0), so already prints absolute paths — clickable as-is.