src

Imported from zchee/zmux-old (src/AGENTS.md). Install upstream with npx skills add zchee/zmux-old --skill src. Copyright stays with the author.

src

Purpose

All application source code for zmux. The root module is main.zig, which re-exports every submodule and serves as the entry point for both the binary and the test suite. Top-level files implement the client/server architecture, while subdirectories organize domain-specific functionality.

Key Files

Subdirectories

For AI Agents

Working In This Directory

• main.zig is both the binary entry point and the test root — all modules must be referenced in its test block
• Adding a new module requires: (1) pub const import in main.zig, (2) _ = module; in the test block
• Top-level files handle the client/server architecture; domain logic belongs in subdirectories
• The data flow is: client.zig u2192 protocol.zig u2192 server.zig u2192 cmd/cmd.zig u2192 session/window/pane state
• PTY output flow: pty fd u2192 server_loop.zig (PaneState.processPtyOutput) u2192 input_handler.zig u2192 screen/

Testing Requirements

• Run zig build test — it compiles from main.zig which pulls in all modules
• Each file should have inline test blocks for its own logic
• Test files in cmd/ (e.g., tmux_equivalent_test.zig) are imported by main.zig

Common Patterns

• Allocator-based init/deinit lifecycle on all heap-owning types
• std.ArrayListAligned(T, null) initialized with .empty for growable collections
• packed struct for flags and bitfields
• Conditional compilation via builtin.os.tag for platform-specific code
• VTable-based polymorphism for the renderer interface

Dependencies

Internal

• Every subdirectory depends on core/ for colour, logging, UTF-8, allocator
• cmd/ depends on nearly every other module (server, session, window, layout, copy, hooks, etc.)
• server_loop.zig bridges terminal/input.zig, input_handler.zig, and screen/

External

• std (Zig standard library)
• libc via std.c for POSIX syscalls