# Winix

Cross-platform CLI tool suite for the gaps between Windows and *nix. Native binaries (AOT-compiled .NET), no runtime required.

## Tools

- [timeit](docs/ai/timeit.md): Time a command — wall clock, CPU, memory, exit code. Replaces POSIX `time`.
- [squeeze](docs/ai/squeeze.md): Multi-format compression/decompression (gzip, brotli, zstd). Replaces `gzip`/`brotli`/`zstd`.
- [peep](docs/ai/peep.md): Watch a command on interval + re-run on file changes. Replaces `watch` + `entr`.
- [wargs](docs/ai/wargs.md): Build and execute commands from stdin. Replaces `xargs` with sane defaults.
- [files](docs/ai/files.md): Find files by name, size, date, type, and content. Replaces `find` with glob patterns and clean output.
- [less](docs/ai/less.md): Native terminal pager with ANSI colour passthrough, search, follow mode, and modern defaults. Replaces `less` on Windows and improves defaults on all platforms.
- [man](docs/ai/man.md): Cross-platform man page viewer with colour, hyperlinks, and pager support. Fills the gap on Windows where no `man` command exists.
- [treex](docs/ai/treex.md): Enhanced directory tree with colour, filtering, sizes, and clickable links. Replaces `tree`.
- [whoholds](docs/ai/whoholds.md): Find which processes are holding a file lock or binding a network port. Replaces `handle.exe` (Sysinternals) on Windows and wraps `lsof` on Linux/macOS.
- [schedule](docs/ai/schedule.md): Cross-platform task scheduler with cron expressions. Unified interface over Windows Task Scheduler (`schtasks.exe`) and Unix `crontab`.
- [nc](docs/ai/nc.md): Cross-platform netcat replacement — TCP/UDP send/receive, port checks (single/range/list), and TLS clients. Replaces verbose `Test-NetConnection` on Windows and normalises behaviour across BSD/GNU/ncat forks on Unix.
- [winix](docs/ai/winix.md): Installer and lifecycle manager for the Winix CLI tool suite. Installs, updates, and uninstalls all tools via your platform's native package manager.

## Key Features for AI Agents

- Every tool supports `--describe` for structured JSON metadata (flags, types, examples, composability, platform scope)
- Every tool supports `--json` for machine-parseable output with standard fields
- Consistent exit codes across all tools (0 = success, 125 = usage error)
- Tools compose via pipes: `files ... | wargs ...` replaces `find ... | xargs ...`
- All current tools are cross-platform. Each tool's `--describe` output includes a `platform` section explaining what it replaces and its value on each OS.

## Quick Reference

Run `<tool> --describe` to get full structured metadata for any tool.
Run `<tool> --help` for human-readable help.

## Install

Available via Scoop (Windows), winget (Windows), .NET tool (cross-platform), or direct download.
See: https://github.com/Yortw/winix