# Krillinai CLI

> Krillinai CLI is an Agent Skill for apps & automation published in the krillinai/KrillinAI repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when an agent needs to operate KrillinAI through its CLI, choose the right stage command, inspect CLI outputs, or run subtitle, TTS, landscape render, and portrait render tasks from a YouTube/local video input.

- Skill name: `krillinai-cli`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/krillinai/KrillinAI/blob/HEAD/skills/krillinai-cli/SKILL.md
- Repository: krillinai/KrillinAI (10,503 GitHub stars when collected)

## SKILL.md

# KrillinAI CLI

Use this as the top-level routing skill for KrillinAI command-line work.

## Quick Start

Prefer the repo-local binary:

```bash
./build/krillinai-cli <command> [flags]
```

If it does not exist, build it first:

```bash
go build -o build/krillinai-cli ./cmd/cli
```

For common JSON, manifest, outputs, and error semantics, read:

```text
skills/krillinai-cli/references/cli-contract.md
```

## Choose The Command

| User intent | Command / skill |
|---|---|
| Generate source, target, bilingual, and short vertical subtitles | `subtitle`; use `krillinai-subtitle` |
| Generate target-language dubbing from subtitles | `tts`; use `krillinai-tts` |
| Create landscape videos | `render-horizontal`; use `krillinai-render-horizontal` |
| Create portrait/short-form videos | `render-vertical`; use `krillinai-render-vertical` |

`pipeline`, `cover`, and `status` are planned/reserved surfaces in the current CLI. Use their skills for planning or dry-run documentation only unless the implementation has been wired in.

## Operating Rules For Agents

- Use a dedicated `--workdir`; do not scatter outputs in the repo root.
- Prefer `--dry-run` when validating command shape or planning a run.
- Parse stdout JSON and `krillinai_manifest.json`; do not parse normal logs.
- Reuse manifest outputs for later stages instead of guessing filenames.
- If a command fails, classify by `error.kind`: `usage`, `retryable`, `dependency`, or `internal`.
- Avoid rerunning expensive stages if the manifest already has valid upstream outputs.

## Minimal Workflow

```bash
./build/krillinai-cli subtitle "https://www.youtube.com/watch?v=VIDEO_ID" \
  --origin-lang en \
  --target-lang zh_cn \
  --workdir tasks/demo \
  --caption-source any

./build/krillinai-cli render-vertical \
  --workdir tasks/demo \
  --video tasks/demo/origin_video.mp4 \
  --subtitle tasks/demo/short_origin_mixed_srt.srt
```

---

Source: https://www.openparable.com/skill/apps-automation/krillinai-cli (OpenParable). Cite the canonical URL above.
