# CLI Reference

The packaged executable is `zonegaze-flow`. The historical manpage still uses the `kanban` command name for compatibility.

Direct Mac and Android users do not need this command-line path. Use the [platform application guides](../platforms/README.md) for app install and launch.

## Start Runtime

```bash
zonegaze-flow [--port <number|auto>] [--host <host>] [--no-open]
```

Common usage:

```bash
npx zonegaze-flow
npx zonegaze-flow --no-open
npx zonegaze-flow --port 4217 --host 127.0.0.1
```

## Task Commands

Task commands return JSON and use kebab-case flags.

```bash
zonegaze-flow task list
zonegaze-flow task create --prompt "Implement API pagination"
zonegaze-flow task update --task-id <id> --prompt "Updated prompt"
zonegaze-flow task link --task-id <id> --linked-task-id <id>
zonegaze-flow task unlink --dependency-id <id>
zonegaze-flow task start --task-id <id>
```

## Hook Commands

Hook helpers are used by agent adapters and runtime wrappers.

```bash
zonegaze-flow hooks ingest --event activity --activity-text "Running tests"
zonegaze-flow hooks notify --event to_review
zonegaze-flow hooks codex-wrapper --real-binary /path/to/codex -- <agent args>
```

## Update

```bash
zonegaze-flow --update
```

Update support depends on installation type.

## Source

- [manpage](../../man/zonegaze-flow.1)
- [Generated source reference](generated/source/README.md)
