Getting started

Experimental

This page explains how to try tak, not how to adopt it. tak has no support or stability guarantees.

Install

Install the published crate:

cargo install tak-cli

Prebuilt binaries may also be available on the GitHub releases page.

Instruction counting requires Valgrind and is unavailable on Apple Silicon and Windows. Without it, tak records timing only.

Measure one command

Put the command after -- so tak never interprets its flags:

tak run -- mycli --version

Use --bench to give an ad-hoc measurement a stable name:

tak run --bench startup -- mycli --version

Declare repeatable benchmarks

Create tak.toml in the project root:

[bench.startup]
cmd = ["./target/release/mycli", "--version"]

[bench.help]
cmd = "mycli --help"
runs = 10

Then run every declaration or select one:

tak run
tak run --bench startup

String commands are split on whitespace. There is no shell, quoting, globbing, or pipeline syntax. Use an argument list when boundaries matter.

Continue with benchmark configuration or record results in git notes.