bud

/bud — Create New Oracle

"Yeast budding — any oracle can spawn a new oracle."

Facilitate maw bud from inside a Claude Code session. The oracle reproduction command.

Usage

/bud myoracle                    # Bud from current oracle
/bud myoracle --split            # Bud + show child in right pane
/bud myoracle --split --birth    # Bud + split + child runs /birth
/bud myoracle --from mawjs       # Bud from specific parent
/bud myoracle --org ARRA-01      # Target different GitHub org
/bud myoracle --note "why"       # Birth note in ψ/memory/learnings/
/bud myoracle --dry-run          # Preview only
/bud myoracle --root             # Root oracle — no parent lineage

Step 0: Detect maw CLI

if command -v maw &>/dev/null; then
  MAW="maw"
elif [ -x "$HOME/.bun/bin/maw" ]; then
  MAW="$HOME/.bun/bin/maw"
else
  MAW=""
  echo "⚠️ maw CLI not found — using standalone mode"
fi

Mode 1: With maw (preferred)

Delegate to maw bud — it handles all 8 steps (repo, ψ/, CLAUDE.md, fleet config, soul-sync, commit, wake):

$MAW bud "$NAME" ${FROM:+--from "$FROM"} ${ORG:+--org "$ORG"} ${NOTE:+--note "$NOTE"} ${SPLIT:+--split} ${DRY_RUN:+--dry-run}

If --birth flag

After bud completes, chain /birth via wake:

$MAW wake "$NAME" --task '/birth'

This sends /birth as the new oracle's first message — creates Issue #1 with birth props before /awaken.

Show result

🧬 Budded: ${FROM:-current} → $NAME

  Repo:    ${ORG}/${NAME}-oracle
  Fleet:   ~/.config/maw/fleet/${NUM}-${NAME}.json
  Purpose: (to be defined by /awaken)

  Next: run /awaken in the new oracle for full identity setup
  Or:   maw hey $NAME '/awaken'

If --split flag (watch the child being born)

With maw: --split is handled natively by maw bud (commit a8ffce9). It uses hostExec + listSessions() to resolve the child session and split the pane. No raw tmux needed.

Without maw (standalone fallback):

# Check if in tmux
if [ -n "$TMUX" ]; then
  tmux split-window -h -l 50% "cd $TARGET && claude"
  echo "✓ Split — child oracle visible on the right pane"
else
  echo "⚠️ Not in tmux — --split requires tmux."
fi