coding-human

A CLI tool for real-time Q&A between a client and a coder over WebSocket.

Coders register themselves in a queue; clients browse the queue and connect to a coder of their choice.

Repository layout

coding-human/
├── Cargo.toml      # workspace root
├── cli/            # native binary (coding-human)
│   ├── Cargo.toml
│   └── src/
│       ├── main.rs
│       ├── client.rs  # client: browse queue, pick a coder, ask questions
│       └── coder.rs   # coder: join queue, answer questions
└── worker/         # Cloudflare Worker (workers-rs / WASM)
    ├── Cargo.toml
    ├── wrangler.jsonc
    └── src/
        └── lib.rs   # QueueDO + RoomSession + fetch handler

Install (CLI)

cargo install --git https://github.com/ut-code/cli --bin coding-human

Usage

Coder: join the queue

coding-human coder <LABEL>

Registers you in the queue with the given display name, creates a room, and waits for a client to connect. Once connected, questions arrive automatically and you type answers line by line. Press Ctrl+D to finish a response and wait for the next question.

coding-human coder "Alice (Rust / systems)"

Client: ask a question

coding-human client <NAME>

Fetches the list of available coders, lets you pick one, then opens a session. Type questions at the prompt; answers stream back in real time. Type /quit or press Ctrl+D to exit.

Configuration (CLI)

The server URL defaults to http://localhost:8787. Override with a SERVER_URL environment variable or a .env file:

SERVER_URL=https://your-worker.example.com

Local development

# install worker-build once
cargo install worker-build

# start the worker locally on http://localhost:8787
cd worker
npx wrangler dev

Then run the CLI against it (default URL is already http://localhost:8787):

# terminal 1 — coder
coding-human coder "Alice"

# terminal 2 — client
coding-human client "Bob"

Deploy (Worker)

The Cloudflare Worker is written in Rust using workers-rs and compiled to WASM.

# install worker-build once
cargo install worker-build

# build + deploy
cd worker
npx wrangler deploy

The worker exposes:

Method	Path	Description
GET	/queue	List waiting coders { roomId: label }
POST	/queue	Register a coder { label } → { roomId }
DELETE	/queue/:roomId	Deregister a coder
GET (WS)	/rooms/:id/coder	WebSocket for the coder
GET (WS)	/rooms/:id/client	WebSocket for the client

Two Durable Objects back the worker:

• QueueDO — singleton, persists the queue of waiting coders in KV storage
• RoomSession — one per room, relays messages between coder and client using hibernatable WebSockets