kapi exec script

$ kapi script [files...]

Script

Commandexec script

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 script

Flags

Flag	Type	Default	Description
--allow-source-mutation	bool	false	Permit the script to modify the source text (off by default; source is read-only)
--code	string		Inline ES5 JavaScript code
--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})
--output-dir	string		write outputs under DIR (default: rewrite each input in place)
--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)
--script-file	string		Path to a .js file
--source	string	inline	Script source mode (inline, file)
--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
--trace	string		write flow trace JSON to file (for flow visualization)

← Back to the Command Reference