TCP chat server and CLI client in Rust

[cy00r]

Demo

demo-new.mp4

Overview

Async TCP chat server and CLI client built with Tokio. Single chat room where users can join, send messages, and leave.

Features

• Non-blocking async server using Tokio broadcast channel
• Unique username enforcement
• Messages broadcast to all users except the sender
• Graceful cleanup on leave or abrupt disconnect
• CLI client accepts config via env vars or CLI args

Usage

# Start server
cargo run -p server

# Connect as a user
cargo run -p client -- 127.0.0.1 8080 alice

Commands

• send <MSG> — broadcast a message
• leave — disconnect and exit

Testing

cargo test --all   # 14 tests (8 client + 6 server)

Bonus

• ✅ Pre-commit hook — git config core.hooksPath .githooks
• ✅ GitHub Actions CI — runs on every push to any branch
• ✅ E2E smoke test — starts server, connects client, sends message, verifies exit code 0