---
summary: "CLI reference for `SKYKOI koi` (send one koi turn via the Gateway)"
read_when:
  - You want to run one koi turn from scripts (optionally deliver reply)
title: "koi"
---

# `SKYKOI koi`

Run an koi turn via the Gateway (use `--local` for embedded).
Use `--koi <id>` to target a configured koi directly.

Related:

- Koi send tool: [Koi send](/tools/koi-send)

## Examples

```bash
SKYKOI koi --to +15555550123 --message "status update" --deliver
SKYKOI koi --koi ops --message "Summarize logs"
SKYKOI koi --session-id 1234 --message "Summarize inbox" --thinking medium
SKYKOI koi --koi ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
```
