Skip to content
Registry

ide

(alias: shell)v0.3.7

Unix shell + filesystem worker — exec with denylist/timeout/output caps and background jobs; fs::ls|stat|mkdir|rm|chmod|mv|grep|sed|read|write with host jail, denylist, size caps, and sandbox-target forwarding

Install

bash
iii trigger compose::add worker=ide@0.3.7

Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.

Functions15

shell::exec

Function

Run an allowlisted command in the foreground and return its full output. Payload: { command: string (program name), args?: string[], timeout_ms?: number, target?: { kind: 'host'|'sandbox', sandbox_id?: string } }. Returns { stdout, stderr, exit_code, duration_ms, timed_out, stdout_truncated, stderr_truncated }. Do NOT pass argv as an array in 'command' — split program and arguments across the two fields.

Request
valueunknown
Response
valueunknown

shell::exec_bg

Function

Spawn an allowlisted command as a background job. Same payload shape as shell::exec; returns { job_id, argv } immediately. Poll with shell::status, terminate with shell::kill, list with shell::list. Do NOT pass argv as an array in 'command' — use 'command' (string) + 'args' (string[]).

Request
valueunknown
Response
valueunknown

shell::fs::chmod

Function

Change permissions on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::grep

Function

Recursive regex search on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::ls

Function

List directory contents on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::mkdir

Function

Create a directory on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::mv

Function

Move/rename a path on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::read

Function

Stream a file from a host path or sandbox via StreamChannelRef

Request
valueunknown
Response
valueunknown

shell::fs::rm

Function

Remove a path on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::sed

Function

Find-and-replace on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::stat

Function

Stat a path on host or sandbox

Request
valueunknown
Response
valueunknown

shell::fs::write

Function

Stream a file to a host path or sandbox via StreamChannelRef

Request
valueunknown
Response
valueunknown

shell::kill

Function

Kill a running background job

Request
valueunknown
Response
valueunknown

shell::list

Function

List all background jobs

Request
valueunknown
Response
valueunknown

shell::status

Function

Get status of a background job

Request
valueunknown
Response
valueunknown

Triggers0

No triggers registered

Search the registry

Find workers, kits and executables, or jump to a page.