Guide
What kizz is
Getting started
The kizz.md file
Caching
Recommended usage
Observing a command
Running one task
Planned features
Reference
Command line
Overview
kizz and its global options
--color
--quiet
--no-banner
-v, --verbose
-h, --help
-V, --version
kizz build
TARGETS
--explain
--cache-unknown-syscalls
--fail-unchecked
--sequential
--parallel
-h, --help
Output
Exit statuses
Examples
kizz why
--cached
PATH
-h, --help
Output
Exit statuses
Examples
kizz list
TARGETS
-h, --help
Output
Exit statuses
Examples
kizz cache
-h, --help
kizz cache clean
-h, --help
Output
Exit statuses
Examples
kizz cache reset
PATH
--all
--yes
-h, --help
Output
Exit statuses
Examples
kizz execute
--output
--compact
--json
PROGRAM
-h, --help
Exit statuses
Examples
kizz run
NAME
ARGUMENTS
--no-cache
--explain
--fail-unchecked
--cache-unknown-syscalls
--output
--compact
--json
-h, --help
Output
Exit statuses
Examples
kizz graph
-h, --help
Exit statuses
kizz image
-h, --help
Exit statuses
Environment variables
The kizz execute report
The kizz.md format
Starlark API
Overview
run()
argv
stdin
env
cwd
capture
stream
always
untraced
network
ignore
track
timestamps
machine
expect
Program lookup
Failures
The result, run_result
rc
signal
stdout
stderr
output
cached
Checking a result
env
env.caller()
env.inherit()
env.load_file()
env.read()
env.set()
env.update()
env.unset()
env.get()
env.dict()
env.clear()
Dotenv files
fs
fs.read()
fs.write()
fs.read_json()
fs.write_json()
fs.exists()
fs.list()
fs.glob()
task
task.dir
task.file
task.line
task.name
task.heading
task.targets
task.selected
task.args
json
json.encode()
json.decode()
print()
fail()
load()
Project
measurements
Rust API appendix
Project
This section holds reports about kizz itself.
Pages
Phase 9 measurements
: tracing overhead, cache checks, discovery and cache cleanup, measured on real projects.