Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dedaluslabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Run a command

Execute is asynchronous: create returns immediately, you poll until , then fetch output. 
dedalus machines:executions create \
  --machine-id "$MACHINE_ID" \
  --command '["/bin/bash", "-c", "uname -a"]'

​
Create

Start an execution. Returns immediately. 
dedalus machines:executions create --machine-id "$MACHINE_ID" --command '["whoami"]'
​
machine_id
string
required
The machine to run the command on.
​
command
string[]
required
argv array. The first element is the executable; the rest are arguments.
​
stdin
string
Bytes to pipe to the process’s stdin.
​
env
object
Extra environment variables for this process.
​
cwd
string
default:"/root"
Working directory.
​
timeout_ms
integer
Hard kill after this many milliseconds.

​
Retrieve

Get the current state of an execution. Use this to poll until terminal. 
dedalus machines:executions retrieve --machine-id "$MACHINE_ID" --execution-id "$EXEC_ID"
​
machine_id
string
required
The machine that owns the execution.
​
execution_id
string
required
The execution to retrieve.

​
List

List executions on a machine, newest first. 
dedalus machines:executions list --machine-id "$MACHINE_ID"
​
machine_id
string
required
The machine whose executions you want to list.
​
cursor
string
Pagination cursor from a prior page’s next_cursor.
​
limit
integer
Max items per page.

​
Delete

Cancel a running execution. No-op if already terminated. 
dedalus machines:executions delete --machine-id "$MACHINE_ID" --execution-id "$EXEC_ID"
​
machine_id
string
required
The machine that owns the execution.
​
execution_id
string
required
The execution to cancel.

​
Events

Per-execution event log: stdout/stderr chunks plus lifecycle transitions. Cursor-paginated. 
dedalus machines:executions events --machine-id "$MACHINE_ID" --execution-id "$EXEC_ID"
​
machine_id
string
required
The machine that owns the execution.
​
execution_id
string
required
The execution whose events you want to read.
​
cursor
string
Pagination cursor from a prior page’s next_cursor.
​
limit
integer
Max events per page.

​
Output

Output returns the command’s captured stdout and stderr after the execution finishes. 
dedalus machines:executions output --machine-id "$MACHINE_ID" --execution-id "$EXEC_ID"
​
machine_id
string
required
The machine that owns the execution.
​
execution_id
string
required
The finished execution whose output you want.
Last modified on May 2, 2026