> ## Documentation Index
> Fetch the complete documentation index at: https://iii.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Worker Registry

> A central repository of iii workers.

## Browsing the registry

The iii Worker Registry at [workers.iii.dev](https://workers.iii.dev/) is the index of installable
workers. Each worker page lists the functions and trigger types it provides, its configuration
schema, supported platforms, and agent skills. Use that information to locate a worker that fulfills
a capability your project needs.

Workers can also be found on Docker and OCI-compatible registries.

## Adding a worker

`iii worker add` accepts three sources. In every case the worker is added to your project's
`config.yaml` and started automatically.

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
iii worker add iii-state                # registry name
iii worker add ./workers/my-worker      # local path
iii worker add ghcr.io/org/worker:tag   # Docker or OCI image
```

> [!NOTE]
>
> Registry workers are published with semver versions. For how versions are picked, pinned with
> `@<version>`, updated, and recorded in `iii.lock`, see [Versioning and
> pinning](https://iii.dev/docs/0-12-0/using-iii/workers.md#versioning-and-pinning) and [Updating a
> worker](https://iii.dev/docs/0-12-0/using-iii/workers.md#updating-a-worker) on the Workers page.

> [!NOTE]
>
> For removing workers and the broader `iii worker` subcommand set (start, stop, restart, sync,
> verify, etc.), see [Workers](https://iii.dev/docs/0-12-0/using-iii/workers.md).

## Artifact types

Each registry worker is published as either a native binary (with per-platform artifacts for macOS,
Linux, and Windows) or as a Docker / OCI compatible image that runs on every supported platform.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.