kiste exec – Kiste Docs

kiste exec [OPTIONS] [NAME] -- <COMMAND>...

Argument	Description
`[NAME]`	Kiste name, `current`, or `self`. Omit to use the current selection.
`-- COMMAND...`	Remote command. Prefix it with `--`.

Option	Description
`--id ID`	Stable command UUID, enabling cancellation from another agent.
`--cwd DIR`	Working directory inside the Kiste.
`--env KEY=VALUE`, `-e KEY=VALUE`	Environment variable in KEY=VALUE form. Repeat as needed. Repeatable.

Examples

kiste exec -- git status --short
kiste exec current --cwd /workspace -- npm test
kiste exec build -e CI=true -- sh -c 'make test'
kiste exec build --id 550e8400-e29b-41d4-a716-446655440000 -- npm test
kiste exec build --output ndjson -- make test

ARGV is passed exactly and standard input is not forwarded; pipe input with kiste ssh NAME -- CMD < file. A requested login shell such as sh -lc runs the image's login profile; use sh -c when stdout must contain only command output.

Global options such as --json work with every command; see the CLI overview.