> ## 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.

# CLI

> The iii CLI: discover commands, trigger functions, and manage iii itself.

For the most current list of commands, flags, and defaults, ask the binary directly:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
iii --help            #lists iii's flags and available subcommands
iii subcommand --help #lists the specific actions each sucommand accepts
```

Each subcommand's help also provides the defaults and environment variables that affect each
command.

## Trigger a function from the CLI

`iii trigger <function-id> [arg=value ...]` invokes a registered function against a running engine.
The engine routes the call to whatever worker registered the function; no trigger registration is
involved.

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
iii trigger math::add a=2 b=3
```

> [!NOTE]
>
> For the full invocation surface, payload formats, fire-and-forget, queue-routed actions, and the
> equivalent SDK call from worker code, see [Triggers / Call a function
> directly](https://iii.dev/docs/0-12-0/using-iii/triggers.md#call-a-function-directly).

## Subcommands

| Subcommand | What it does |
| - | - |
| `iii trigger` | Invoke a registered function on a running engine. |
| `iii worker` | Manage workers: add, remove, list, start/stop, update, verify. See [Workers](https://iii.dev/docs/0-12-0/using-iii/workers.md). |
| `iii project` | Manage iii projects: scaffold a new one, generate Docker assets. See [Deployment](https://iii.dev/docs/0-12-0/using-iii/deployment.md). |
| `iii console` | Launch the iii web console. See [Console](https://iii.dev/docs/0-12-0/using-iii/console.md). |
| `iii cloud` | Manage hosted iii deployments. See [Managing iii Cloud deployments](#managing-iii-cloud-deployments). |
| `iii update` | Update iii and its managed binaries. See [Updating iii itself](#updating-iii-itself). |

Running `iii` with no subcommand starts the engine from `./config.yaml` (or the path passed to
`--config`); pass `--use-default-config` to start with the built-in defaults instead.

## Managing iii Cloud deployments

The `iii cloud` subcommand group will manage hosted iii deployments. See
[Deployment](https://iii.dev/docs/0-12-0/using-iii/deployment.md#iii-cloud-deployments) for details about the iii cloud.

> [!NOTE]
>
> iii's cloud will be available soon.

## Updating iii

`iii update` refreshes iii and its managed binaries to their latest versions. This is distinct from
`iii worker update`, which refreshes pinned worker versions inside a project.

> [!NOTE]
>
> Specific targets can be updated individually via `iii update [target]`. Run `iii update   --list-targets` to see the list of targets.


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