Configuration#

Session settings (output and process filters) live in a TOML config file, not CLI flags. tinytap config init && tinytap just works. See config init in CLI surface below.

CLI surface#

The only CLI surface is one-shot actions, not session settings:

Flag / command	What it does
`--config <path>`	Point at an alternate config file
`--version`	Print build metadata, exiting before any eBPF load
`config init`	Write a fully-populated default config file
`doctor`	Read-only preflight checks (see Troubleshooting)

Search order and defaults#

Search order when --config <path> isn’t given: ./tinytap.toml, then $XDG_CONFIG_HOME/tinytap/config.toml (falling back to ~/.config/tinytap/config.toml). Finding neither is not an error, and the defaults below apply.

output = "auto"   # auto | stdout | tui

[filter]
pid  = []         # []uint32 — schema only, not yet enforced by the BPF program
comm = []         # []string — schema only, not yet enforced by the BPF program