tmux config with built-in terminal automation and agent-to-agent communication.
1.5k
Stars
85
Forks
7
Open issues
1
Contributors
AI Analysis
smux is a tmux configuration framework with built-in terminal automation and agent-to-agent communication via the tmux-bridge CLI. It's specifically designed for AI agents (Claude Code, Codex, Gemini) to read, type, and send keys across tmux panes, enabling workflows where one agent can prompt another and receive responses. This tool is narrowly focused on AI agent orchestration in terminal environments and is not a general-purpose tmux config for typical developers.
Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.
AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.
tmux configuration layer with agent-to-agent CLI bridge for AI automation
smux packages tmux with Option-key keybindings and tmux-bridge, a CLI tool enabling AI agents (Claude Code, Codex, etc.) to read panes, type input, and communicate across terminal sessions. Built for developers automating multi-agent workflows and for developers who want lightweight tmux defaults. Created February 2026; gained 1,455 stars in ~4 months with moderate ongoing growth (8 stars/week as of July 2026).
Launched February 2026 as a personal tmux config paired with agent automation primitives. Appears designed to address the specific problem of coordinating multiple AI agents in shared terminal environments — a gap that emerged as LLM coding tools became more capable at self-direction.
Rapid early adoption (1,455 stars in 16 weeks) suggests product-market fit within a narrow segment: developers using AI agents for code tasks. Growth has plateaued to ~8 stars/week, indicating the addressable market may be specialists rather than broad developer adoption. No evidence of viral or hype-driven growth curves.
adoption not verified — no documented case studies, testimonials, or metrics showing production usage. Claims compatibility with 40+ agents via skills.sh registry, but registry presence does not confirm end-user deployment.
Based on README: shell script installer, tmux configuration file, and bash-based tmux-bridge CLI. Likely architecture is lightweight wrapper around tmux with shell bindings for IPC. Actual implementation quality cannot be assessed from README alone.
not documented in README
Last push 2026-06-17 (14 days before analysis date); active maintenance. Project is 4 months old, so 'mature' is not applicable, but recent commits show continued development. No stale signals.
ADOPT IF: you are an early-stage AI agent developer/researcher building multi-agent orchestration workflows and want a lightweight, agent-aware terminal setup. AVOID IF: you need proven production stability, extensive documentation, or broad ecosystem support — this is a 4-month-old specialized tool. MONITOR IF: you manage teams of developers using Claude Code or similar agents; watch whether enterprise adoption signals emerge and whether the tmux-bridge API stabilizes.
Independent dimensions
Mainstream potential
3/10
Technical importance
6/10
Adoption evidence
2/10
- Adoption limited to niche: early-stage AI agent developers; mainstream developer adoption unlikely given narrow use case
- No documented test coverage or CI/CD signals visible; maintenance burden on single maintainer (ShawnPana) is unknown
- tmux-bridge IPC model may have scaling or reliability limitations for large numbers of concurrent agent panes — not addressed in README
- Breaking change risk: project is pre-1.0, no semantic versioning or stability guarantees documented
- Integration surface with 40+ agent tools via skills.sh is large and unverified; agent API instability could break compatibility
Likely to remain a specialized tool for AI agent developers and researchers. Growth may plateau unless enterprise orchestration use cases emerge. If successful, may inspire tmux extensions in competing multiplexers or be absorbed into agent frameworks.
Newsletter
Get analyses like this every Monday
Free weekly digest of the most interesting open-source discoveries.
Languages
No language breakdown available.
Information
- Language
- Shell
- License
- MIT
- Last updated
- 3w ago
- Created
- 4mo ago
- Analyzed with
- anthropic/claude-haiku-4-5
Stars over time
No commit data available.
Contributors over time
Top 100 contributors only — repos with more will plateau at 100.
Open issues
No open issues — clean slate.
Open pull requests
No open pull requests.
Top contributors
Contributor data not available yet.
Recent releases
No releases published yet.
Similar repos
standardagents/dmux
dmux is a multiplexer for managing multiple AI coding agents in parallel using...
| Repository | Stars | Week Δ | Language | Score | Updated |
|---|---|---|---|---|---|
|
ShawnPana/smux
this
|
1.5k | +3 | Shell | 7/10 | 3w ago |
|
standardagents/dmux
|
1.7k | — | HTML | 7/10 | 1d ago |
 greymd/tmux-xpanes
|
2.1k | — | Shell | 8/10 | 2mo ago |
 tmuxinator/tmuxinator
|
13.7k | — | Ruby | 8/10 | 1w ago |
 manaflow-ai/cmux
|
24.1k | — | Swift | 8/10 | 8h ago |
 coder/mux
|
1.9k | — | TypeScript | 7/10 | 13h ago |
smux is a config + CLI layer atop tmux, not a replacement. tmux (47k stars) is the underlying terminal multiplexer; smux adds ergonomic defaults and agent bridge.
tmuxinator (13.6k stars, Ruby) manages tmux project layouts via YAML. smux focuses on keyboard ergonomics and agent IPC; different use cases.
mux (1.8k stars, TypeScript) is a tmux session manager. smux adds agent-to-agent communication bridge; orthogonal feature set.
dmux (1.6k stars, HTML) — scope unclear from star count and language tag alone; insufficient metadata to compare.
cmux (23.2k stars, Swift) — likely an agent-native mux tool; higher star count but different language and origin suggest different positioning.