Command reference
oko-cli pty broker-spawn
Starts an executable in a new broker-owned PTY session.
Invocation
oko-cli pty broker-spawn --executable PATH [--cwd DIR] [--socket PATH] [-- ARG...]Inputs and options
- Required --executable.
- --cwd selects the working directory; --socket selects the broker; arguments follow --.
Output and state effect
- Creates a broker PTY session and prints its record as pretty JSON.
Refusals and safe exits
- Refuses a missing executable; broker spawn or serialization failures exit unsuccessfully.