Soul-Brews-Studio/inbox

/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

$INBOX is absolute (set as $ROOT/ψ/inbox in Mode 1 Step 0), so ls already prints absolute paths — clickable as-is.

For each file, show:

📥 20260323 21:12 — fix-auth-bug (from peter)
   First 2 lines of content...

If MCP available, also run:

oracle_inbox(limit=10)

/inbox read <topic>

Find and display the most recent file matching the topic:

ls -1t "$INBOX"/*<topic>*.md 2>/dev/null | head -1

Read and display full content.

---

Mode 2: Write

/inbox write <topic>

TS=$(date +%Y%m%d_%H%M)
SLUG=$(echo "<topic>" | tr ' ' '-' | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9-]//g')
FROM=$(echo "<sender>" | tr ' ' '-' | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9-]//g')
FILE="$INBOX/${TS}_${SLUG}_from_${FROM}.md"

Ask the user: "What do you want to note?" (unless content is provided after topic)

Write the file:

---
topic: <topic>
from: <current-oracle-name>
timestamp: YYYY-MM-DD HH:MM
---

<user's content>

If MCP available, also call:

oracle_handoff(content, slug)

This syncs to vault for cross-Oracle discovery.

Confirm write (announce-mode — absolute paths required)

announce-mode → absolute path (no ψ/, no ~/, no $VAR, no ...).

Use: echo "marker: $RESOLVED_PATH" — bash substitutes. See CONVENTIONS.md.

echo "📥 Written: $FILE"

---

Mode 3: List All

/inbox ls

Same as read but show ALL items (no limit), with file sizes:

ls -lht "$INBOX"/*.md 2>/dev/null | grep -v schedule.md

Also count handoffs:

echo "📁 Handoffs: $(ls "$INBOX/handoff/" 2>/dev/null | wc -l) files"

---

Mode 4: Clean

/inbox clean

Move items older than 7 days to archive:

ARCHIVE="$ROOT/ψ/archive/inbox"
mkdir -p "$ARCHIVE"
find "$INBOX" -maxdepth 1 -name "*.md" -not -name "schedule.md" -mtime +7 -exec mv {} "$ARCHIVE/" \;

Report what was moved. Never delete — move to archive (Nothing is Deleted).

---

Who Can Write?

Any Oracle, any skill, any agent. The only rule: timestamp before topic in filename.

| Writer | How | Example | |--------|-----|---------| | /inbox write | This skill | 20260323_2112_idea_from_neo.md | | /forward | Handoff | ψ/inbox/handoff/20260323_2112_session-forward.md | | Another Oracle | /talk-to + write | 20260323_2112_status-update_from_odin.md | | Agent directly | oracle_handoff() MCP | Same format |

---

ARGUMENTS: $ARGUMENTS