retix 1.2.0

RETIX - The Optic Nerve for Autonomous Agents

RETIX

RETIX - The Optic Nerve for Autonomous Agents.

RETIX is a local-first vision CLI for coding agents. It analyzes screenshots, extracts visible text, and verifies visual claims with deterministic defaults suitable for engineering workflows.

Installation

git clone https://github.com/SNiPERxDD/retix.git
cd retix
python3 -m pip install -e .

Quick Start

retix setup
retix config
retix describe test_ui_screenshot.png

Core Commands

Describe

retix describe <image>
retix describe <image> --prompt "focus on form validation"
retix describe <image> --json

OCR

retix ocr <image>
retix ocr <image> --json

Check

retix check <image> "submit button is visible"
retix check <image> "error banner is red" --json

Setup and Configuration

retix setup
retix setup --non-interactive
retix config

retix setup performs:

• environment validation (macOS tooling checks)
• virtual environment creation in ~/.cache/retix/venv
• hardware-aware model tier selection (2B, 8B, MoE profile)
• optional custom Hugging Face model repo selection with format and reachability checks
• editable install (pip install -e .) for global command availability

retix config initializes project context in .retix/ and updates .gitignore with RETIX-specific ignore entries.

Model Management

retix model list
retix model info
retix model switch 2b
retix model switch 8b
retix model switch moe

Benchmarking

retix bench

Daemon Mode

retix daemon start
retix daemon status
retix daemon stop

retix daemon stop performs deterministic shutdown:

• sends SIGTERM
• waits for graceful exit
• escalates to SIGKILL on timeout
• removes stale PID/socket files

Project Context

RETIX project context is stored in:

.retix/
  SKILL.md
  config.yaml

The generated skill file uses a strict metadata header:

• ID
• Name
• Version

Security and Hygiene

• Unix daemon socket permissions are set to 600.
• Stale sockets are cleaned up when daemon responsiveness checks fail.
• Local project context and archive artifacts are ignored through .gitignore.

Testing

Unit and Integration Tests

pytest tests

Real-World Screenshot Suite

RETIX_RUN_REAL_WORLD=1 pytest tests/real_world -m real_world

The real-world suite covers:

• login screenshots
• dashboard screenshots
• code editor screenshots

If fixtures are missing, tests are skipped with explicit reasons.

License

MIT License.