Fork Landscape
cmux is built from 7 repositories. This issue tracks the full fork topology, novel libraries, and opportunities for upstreamable contributions.
Repository Map
Novel Libraries (Tier 1 — Ready to Publish)
These are standalone, dual-licensed (Zlib/MIT) Zig libraries with no cmux-specific dependencies:
- zig-ctap2 — FIDO2/CTAP2 USB HID in pure Zig. Direct YubiKey/SoloKeys communication. macOS (IOKit) + Linux (hidraw). 16 C FFI functions, property-based tests, PIN protocol v2.
- zig-keychain — Cross-platform secrets storage. macOS Security.framework + Linux libsecret/D-Bus. 4 C FFI functions with upsert semantics.
- zig-crypto — Minimal crypto primitives. SHA-256, HMAC, AES-256-CBC, PBKDF2, CSPRNG, ECDH P-256, Ed25519. 19 exported C functions.
Ghostty Fork PRs (Tier 2 — Rebase onto Upstream)
Changes in Jesssullivan/ghostty that are generally useful:
| Change |
Commits |
Effort |
Value |
| OSC 99 kitty notification parser |
2033ffebc, a75615992 |
Low |
Medium — generic terminal sequence |
| macOS display link restart fix |
05cf31b38 |
Very Low |
Medium — fixes rare vsync hang |
| macOS resize stale-frame mitigation |
a3588ac53, 9ba54a68c |
Medium |
Medium — UX improvement |
| Linux embedded platform variant |
e109d653c |
Low |
Medium — follows visionOS pattern |
Fork-only changes documented in docs/ghostty-fork.md.
CI/Template Patterns (Tier 3 — Share as Reference)
- Upstream sync workflow (
.github/workflows/upstream-sync.yml) — Conflict classification with risk assessment. Reusable by any fork.
- QEMU distro testing (
nix/tests-distro.nix + test-distro.yml) — Package install verification via nix-vm-test VMs. Novel for terminal CI.
- libghostty.nix — Standalone Nix derivation for building libghostty without full app. Useful once libghostty stabilizes in nixpkgs.
Action Items
Fork Landscape
cmux is built from 7 repositories. This issue tracks the full fork topology, novel libraries, and opportunities for upstreamable contributions.
Repository Map
Novel Libraries (Tier 1 — Ready to Publish)
These are standalone, dual-licensed (Zlib/MIT) Zig libraries with no cmux-specific dependencies:
Ghostty Fork PRs (Tier 2 — Rebase onto Upstream)
Changes in Jesssullivan/ghostty that are generally useful:
2033ffebc,a7561599205cf31b38a3588ac53,9ba54a68ce109d653cFork-only changes documented in
docs/ghostty-fork.md.CI/Template Patterns (Tier 3 — Share as Reference)
.github/workflows/upstream-sync.yml) — Conflict classification with risk assessment. Reusable by any fork.nix/tests-distro.nix+test-distro.yml) — Package install verification via nix-vm-test VMs. Novel for terminal CI.Action Items