Command reference

oko-cli context host-exec

Executes a bounded host command and returns its structured context-tool result.

Invocation

oko-cli context host-exec --command CMD [--cwd PATH] [--timeout SEC]

Inputs and options

  • Command may use --command, -c, or follow --.
  • --cwd selects a directory; --timeout defaults to 60 seconds.

Output and state effect

  • Runs the command under the host-exec policy and prints result JSON including output/status.

Refusals and safe exits

  • The host-exec policy refuses empty/disallowed commands and unsafe working directories; output serialization failures exit unsuccessfully.