process_start
Starts a command in the background and returns immediately with an id.
Use it for anything that does not exit on its own — a development server, a watcher, a long build you want to follow. For a command that finishes and whose output you need, use run_terminal instead; it waits and returns the result in one call.
The process keeps running after this turn ends. Read what it has printed with process_output and end it with process_stop. Runs a shell command, so it is gated by your approval mode.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
command |
string |
Yes | Command to start |
cwd |
string |
No | Directory to run it in. Defaults to the project root. |
port |
number |
No | The port this command listens on, if it is a server. Give it to get back the URL to reach it at — which is not localhost when the sandbox is on. |
Example#
process_start({ command: "…" })Approval#
Gated by the approval mode.
See also#
- Tools — every tool, and which of them can change your files
- Approval modes — what gates the tools that change things
Added in woopcode@0.6.0