Skip to content
Sign in

iii-exec

v0.21.8

Execute shell commands as part of engine startup.

Deprecated

This worker is deprecated and is no longer recommended.

Engine module
Baked into the iii engine; no separate install required.

Install

bash
iii trigger compose::add worker=iii-exec@0.21.8

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

Agent-ready brief for v0.21.8
Install, config, dependencies, readme, skills and API reference, all in one place. Fetch as agent-context.md for an LLM to consume.
The same content rendered as discrete blocks below is exposed as a single markdown document at /registry/workers/iii-exec.md?version=0.21.8. Paste it into an LLM prompt or pipe it through curl from a worker.

Install

iii trigger compose::add worker=iii-exec@0.21.8

Configuration

iii-config.yaml
- exec:

Dependencies

No dependencies for v0.21.8

Readme

README.md

iii-exec

Execute shell commands as part of engine startup — building assets, running migrations, or starting long-lived processes.

Install

iii worker add iii-exec

Resolves from the worker registry at workers.iii.dev.

Skills

Install the iii-exec agent skill for Claude Code, Cursor, and 30+ other agents:

npx skills add iii-hq/iii --full-depth --skill iii-exec

Sample Configuration

- name: iii-exec
  config:
    exec:
      - cd frontend && npm install
      - cd frontend && npm run build
      - bun run --enable-source-maps index-production.js

With file watching:

- name: iii-exec
  config:
    watch:
      - steps/**/*.{ts,js}
      - config/*.json
    exec:
      - cd frontend && npm install
      - cd frontend && npm run build
      - bun run --enable-source-maps index-production.js

Configuration

Field Type Description
exec string[] Required. Sequential pipeline of commands. Intermediate commands must exit 0 before the next starts. The final command is kept running as a long-lived process.
watch string[] Glob patterns that trigger a full pipeline restart on file change.

Because each entry runs as a separate process, shell state is not shared between entries. Use && to chain operations that must share a working directory:

- cd path/to/project && npm run build

If an intermediate command exits with a non-zero code, the pipeline stops and remaining commands are skipped.

Note on watch pattern limitations: Patterns match by root directory and file extension only — the filename portion is ignored. src/**/*.test.ts matches all .ts files under src/, not only test files. Use ** to watch subdirectories recursively: config/*.json only watches the top level of config/, while config/**/*.json watches at any depth. Files without an extension (e.g., Makefile, shell scripts) are never matched.

Skills

API reference (JSON)

No API surface registered for this version

Search the registry

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