Winix.TimeIt 0.3.0

timeit

Time a command and show wall clock, CPU time, peak memory, and exit code.

A transparent wrapper — the child's stdout, stderr, and exit code pass through unmodified.

time equivalent for Windows (and works on Linux/macOS too).

Install

Scoop (Windows)

scoop bucket add winix https://github.com/Yortw/winix
scoop install winix/timeit

Winget (Windows, stable releases)

winget install Winix.TimeIt

.NET Tool (cross-platform)

dotnet tool install -g Winix.TimeIt

Direct Download

Download native binaries from GitHub Releases.

Usage

timeit [options] [--] <command> [args...]

Examples

# Time a build
timeit dotnet build

# JSON output for CI pipelines
timeit --json dotnet test

# One-line format for log files
timeit -1 dotnet publish -c Release

# Force colour even when piped
timeit --color dotnet build 2>&1 | tee build.log

# Use -- when child args look like timeit flags
timeit -- myapp --help

Output Formats

Default (multi-line, stderr):

  real  12.4s
  user  9.1s
  sys   0.300s
  peak  482.0 MB
  exit  0

One-line (-1 / --oneline):

[timeit] 12.4s wall | 9.1s user | 0.300s sys | 482.0 MB peak | exit 0

JSON (--json):

{"tool":"timeit","version":"0.1.0","exit_code":0,"exit_reason":"success","child_exit_code":0,"wall_seconds":12.400,"user_cpu_seconds":9.100,"sys_cpu_seconds":0.300,"cpu_seconds":9.400,"peak_memory_bytes":505413632}

Options

Exit Codes

timeit passes through the child process's exit code. When timeit itself fails:

Ambiguity warning: timeit's 125/126/127 collide with the same codes the child might return on its own. POSIX shells use 127 for "command not found" and timeit follows the convention, so an exit code of 127 from timeit -- foo could mean either "timeit could not find foo" or "foo ran and exited 127 itself" — the bare exit code can't distinguish. For unambiguous detection, use --json and check the exit_reason field: success means the child ran and child_exit_code is its exit code; any other value (usage_error, command_not_found, command_not_executable, start_error) indicates a timeit-side failure where the child never ran.

Colour

• Automatic: colour when outputting to a terminal, plain when piped
• --color forces colour on (overrides NO_COLOR)
• --no-color forces colour off
• Respects the NO_COLOR environment variable (no-color.org)

Part of Winix

timeit is part of the Winix CLI toolkit.