# Hoko CLI

Hoko CLI is a JSON command-line client for the Hoko API. Its release binary bundles its runtime.

## Install

- macOS and Linux: https://cli.hoko.to/install.sh
- Windows PowerShell: https://cli.hoko.to/install.ps1
- Manual archives: https://cli.hoko.to/#downloads

## Authentication

- Human users: `hoko auth login --workspace-id <workspace_id>` uses OAuth and stores credentials in the operating system credential store.
- Automation: set `HOKO_API_KEY`.
- Check state: `hoko auth status`.
- Select a workspace: `hoko workspace select <workspace_id>`.

## Commands

`hoko <resource> list|create|update|delete [--body JSON]`

Resources: `links`, `collections`, `tags`, `partners`, `utm-templates`, `customers`, `analytics`, `events`, `journeys`, `webhooks`, `usage`, `keys`, `lead`, `sale`.

Webhooks also support `verify`, `test`, and `disable`. Deliveries support `list` and `resend`.

Resource commands return JSON. Help and version commands return text. Errors use stderr and non-zero exit codes.

## Links

- Full CLI reference: https://cli.hoko.to/llms-full.txt
- API documentation: https://docs.hoko.to/llms.txt
- Help center: https://help.hoko.to/llms.txt
- OpenAPI: https://api.hoko.to/openapi.json