Skip to content

feat: add Live Session mode to observe active Claude Code sessions#26

Open
Orbasker wants to merge 4 commits intoryanstephen:mainfrom
Orbasker:feat/live-session-bridge
Open

feat: add Live Session mode to observe active Claude Code sessions#26
Orbasker wants to merge 4 commits intoryanstephen:mainfrom
Orbasker:feat/live-session-bridge

Conversation

@Orbasker
Copy link
Copy Markdown

Bruce and Jazz can now connect to a real, running Claude Code session instead of spawning their own isolated CLI process. This lets them reflect what's actually happening in your workflow in real time.

Architecture:

  • Bridge hook (hooks/lil-agents-bridge.mjs) broadcasts NDJSON events from any Claude Code session to ~/.claude/lil-agents/sessions/
  • LiveSession.swift watches the event stream via DispatchSource + polling
  • Session discovery scans .meta files to find active sessions
  • Bidirectional: messages sent from Bruce/Jazz are queued in an inbox and injected as additionalContext on the next tool use

UI:

  • "Live Session" provider added to menu bar with a submenu that dynamically lists all active Claude Code sessions
  • Click a session to connect — characters auto-attach on popover open
  • /sessions slash command for in-terminal refresh

Orbasker and others added 4 commits March 31, 2026 12:57
Bruce and Jazz can now connect to a real, running Claude Code session
instead of spawning their own isolated CLI process. This lets them
reflect what's actually happening in your workflow in real time.

Architecture:
- Bridge hook (hooks/lil-agents-bridge.mjs) broadcasts NDJSON events
  from any Claude Code session to ~/.claude/lil-agents/sessions/
- LiveSession.swift watches the event stream via DispatchSource + polling
- Session discovery scans .meta files to find active sessions
- Bidirectional: messages sent from Bruce/Jazz are queued in an inbox
  and injected as additionalContext on the next tool use

UI:
- "Live Session" provider added to menu bar with a submenu that
  dynamically lists all active Claude Code sessions
- Click a session to connect — characters auto-attach on popover open
- /sessions slash command for in-terminal refresh

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
- Characters roam the full screen width instead of just the dock area
- Both Bruce and Jazz walk simultaneously (removed blocking logic)
- Walk distance uses actual screen width fraction, not fixed 500px reference
- Reduced pauses between walks (3-7s) and sibling separation (5%)
- Added random jumping: ~15% chance per walk, smooth parabolic arc (35px/0.45s)
- Jazz starts moving sooner and matches Bruce's walk range

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Explains the bridge hook installation, settings.json configuration,
and how the file-based IPC architecture works.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Replace 'open Xcode and hit run' with a copy-pasteable terminal command
that builds and installs to /Applications in one shot.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant