/pub

[msuarz]

What

/pub registers the current Claude session as a pub dude.

1. Ensures {project}/.claude/dude/inbox.json exists — local inbox, this dude's own
2. Creates symlink ~/.claude/dudes/{name} -> {project}/.claude/ — global discovery

If running from ~/.claude/ (sup context), no symlink — sup is already global.

Why

Pub dudes are globally discoverable. Any other pub dude can find them via ~/.claude/dudes/ and drop a message in their inbox. Registration is explicit — private by default, pub by choice.

[msuarz]

Done

/pub skill

• /pub [name] registers session as a pub dude
• Creates {cwd}/.claude/dude/inbox.json (local inbox)
• Symlinks ~/.claude/dudes/{name} -> {cwd}/.claude/ (global discovery)
• Skips symlink from sup context (~/.claude/)
• Name defaults to cwd dirname if not passed

Statusline dudes section

• Shows icon + superscript message count per dude
• Icon from CLAUDE.md frontmatter (icon: field)
• Context health color (green/yellow/red) from status.json
• status.json written as side effect of each statusline render
• Sup sees all pub dudes, pub dude sees only itself

Testing

• FakeFS collaborator injected — pure unit tests, no filesystem I/O
• Simulated sup and project cwd scenarios
• 40 tests, 0 failures

Not in scope (separate stories)

• Cleanup on exit
• Message send/receive
• Inbox watching via await

[msuarz]

/pub — final implementation

Skill: commands/pub.md

• /pub [name] — name defaults to basename of cwd
• Creates {cwd}/.claude/dude/inbox.json with [] if not exists
• Writes name into {cwd}/.claude/dude/status.json (merges with existing keys like context)
• Creates symlink ~/.claude/dudes/{name} -> {cwd}/.claude/
• Global sup pubs as "dude" — creates ~/.claude/dudes/dude -> ~/.claude/

Key decisions

• No special-casing for sup — global sup is just another pub dude named "dude", gets a symlink like everyone else
• name in status.json — set at /pub time, used by /msg for sender identity. No basename guessing.
• status.json is shared — statusline writes context, /pub writes name. Merge, don't overwrite.

Structure on disk

~/.claude/
  dude/
    inbox.json          # sup's inbox
    status.json         # {"context": 25, "name": "dude"}
  dudes/
    dude -> ~/.claude/  # self-symlink for discoverability
    rec -> /dev/rec/main/.claude/
    smith -> /dev/self/smith/.claude/