hyrin 0.3.10

Candidate CLI for Hyrin interview sessions

hyrin (Python + Textual)

Candidate CLI for Hyrin interview sessions. Drives pairing, chat, local tool execution, and codebase-state capture for the interviewer.

Install (candidate)

Recommended — provisions Python 3.12 in an isolated environment:

uv tool install --python 3.12 hyrin

Alternative (requires Python ≥ 3.12 already installed):

pipx install hyrin

Plain pip works but pollutes site-packages; not recommended:

pip install hyrin

Tested on macOS and Linux. Windows is not supported in v1.0.

Uninstall

uv tool uninstall hyrin     # if installed via uv
pipx uninstall hyrin        # if installed via pipx
pip uninstall hyrin         # if installed via pip

Run

hyrin <PAIRING_CODE> [--cwd <PATH>] [--server <URL>]

Defaults: --cwd = current directory; --server = http://localhost:3100.

Develop

cd cli
python -m pip install -e ".[dev]"
python -m pytest -v

hyrin/ holds the package; tests/ holds pytest + Textual Pilot tests.

Architecture

• client/ — protocol-only (httpx, websockets, pydantic). No Textual imports.
• tools/ — local FS + run_command execution gated through safety.py.
• ui/ — Textual widgets and CSS. No transport imports.
• app.py — the only place transports meet UI; owns the state machine.

See docs/superpowers/specs/2026-04-16-textual-cli-rewrite-design.md for the full design.