Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

Stars

9

7-day growth

No data

Forks

3

Open issues

0

License

Apache-2.0

Last updated

2026-07-27

Why it is worth attention

It solves a real pain point for developers running multiple Claude Code sessions by providing an automatic, safe, and live-resolved peer-to-peer message bus that works across machines with minimal dependencies (bash, jq, tmux, inotifywait) and a small, auditable codebase.

Who it is for

  • Developers using multiple Claude Code sessions for different projects
  • Engineers who want to automate cross-session information sharing
  • Users of tmux-based terminal multiplexing workflows
  • Developers interested in lightweight, script-based message buses

Use cases

  • Asking a peer session for a configuration value (e.g., port number) it just set
  • Broadcasting a notification to all active Claude sessions
  • Sending a fire-and-forget note to a specific session without waiting for a reply
  • Querying a peer across different machines via SSH for a fact it owns

Strengths

  • Real round-trips: relay can wake an idle session for an answer, not just leave a note
  • Live name resolution: session names are resolved on the fly, reflecting renames instantly
  • Self-cleaning: dead sessions are automatically pruned
  • Safe by design: only a fixed control string is ever typed into another pane, preventing injection

Considerations

  • Requires Linux with tmux for auto-wake; sessions outside tmux fall back to manual (poll) mode
  • Waking a pane while a user is mid-typing appends to the input line
  • Messages are stored as local plaintext files; not encrypted – secrets should not be sent

README quick start

Usage

Description

Real-time message bus for Claude Code sessions — one session asks another, the peer wakes on its own and answers, and the reply lands back in the asking pane. Bash + tmux.

Related repositories

Similar projects matched by category, topics, and programming language.

0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859
jamesob
Featured
jamesob GitHub avatar

local-llm

A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.

AI & Machine LearningLarge Language Models
1,660