kapi exec external-command

$ kapi external-command [files...]

External Command

Commandexec external-command

Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

$ kapi exec external-command

Flags

Flag	Type	Default	Description
--apply-source	bool	false	Process source text
--apply-target	bool	true	Process target text
--args	stringSlice		Command arguments; use ${source} and ${target} as placeholders
--command	string		The command to execute
--concurrency, -j	int	0	max parallel files (0 = auto)
--encoding, -e	string		charset the input is read in; a byte-order mark in the file wins (default: the project's defaults.encoding, then UTF-8)
--engine	string		format engine for detected files: native or a plugin name (default: native, then plugins)
--fail-on-unknown	bool	false	exit with error if any file cannot be processed (default: skip with warning)
--format, -f	string		override input format detection
--json	bool	false	output results as JSON
--map, -m	stringArray		map glob pattern to format (e.g. '*.docx=okf_openxml:test')
--no-warn	bool	false	suppress warnings for skipped files
--output, -o	string		output path template (variables: {dir}, {name}, {ext}, {lang})
--output-dir	string		write outputs under DIR/{lang}/ (default: the target-language file beside the input, mirroring its locale layout; with no target language, the input itself)
--pack	bool	false	when transforming a .kpz, also eject the result to the .kpz (auto-pack)
--parallel-blocks	int	0	fan out block processing across N goroutines (0 = off)
--print-ops	bool	false	write no file and print the change set the run would apply, for kapi apply
--progress	bool	false	show progress bar
--project, -p	string		path to a kapi.yaml project recipe or its directory (auto-discovered from cwd if omitted)
--send-as-stdin	bool	true	Send text via stdin instead of command arguments
--source-lang	string		source language (e.g. en, en-US; defaults to the project's source_language, else en)
--strict	bool	false	alias for --fail-on-unknown
--target-lang	string		target language (e.g. fr, de-DE); one per run
--target-locale	string		Target locale for processing
--timeout	int	30	Timeout in seconds
--trace	string		write flow trace JSON to file (for flow visualization)

← Back to the Command Reference