# KrillinAI CLI

Runs the KrillinAI CLI for subtitles, dubbing, rendering, covers, and voices.

- Repository: https://github.com/krillinai/OpenCreator (14080 stars)
- Category: Media
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add krillinai/OpenCreator --skill krillinai-cli -g -a claude-code -y`
Codex: `npx skills add krillinai/OpenCreator --skill krillinai-cli -g -a codex -y`
Cursor: `npx skills add krillinai/OpenCreator --skill krillinai-cli -g -a cursor -y`
Gemini CLI: `npx skills add krillinai/OpenCreator --skill krillinai-cli -g -a gemini-cli -y`

## Description

Use when an agent needs to build or operate the embedded KrillinAI CLI, choose a supported command, or interpret its JSON, manifest, subtitle, dubbing, render, cover, speech, and voice outputs.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# KrillinAI CLI

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

## Build And Locate The Binary

Build both KrillinAI binaries through the repository script:

```bash
pnpm krillinai:build
```

For the current machine, locate the CLI without assuming a platform or architecture:

```bash
TARGET="$(node -p "process.platform + '-' + process.arch")"
SUFFIX="$(node -p "process.platform === 'win32' ? '.exe' : ''")"
KRILLINAI_CLI="$PWD/.runtime/build/krillinai/$TARGET/bin/krillinai-cli$SUFFIX"
test -f "$KRILLINAI_CLI"
```

The CLI loads `config/config.toml` relative to its process working directory. For real runs from a source checkout, use `runtime/krillinai` as the process working directory and create its ignored `config/config.toml` from `config/config-example.toml` without overwriting an existing file. A release archive should be run from its unpacked package root.

For build layout, configuration, JSON, manifest, output, and error details, 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` |
| Generate a cover from a complete image prompt | `cover`; use `krillinai-cover` |
| Generate speech from plain text | `speech` |
| List provider voice codes for Aliyun, OpenAI, or MiniMax | `voices` |
| Validate a requested multi-stage output plan | `pipeline --dry-run`; use `krillinai-pipeline` |

`pipeline` only validates plans in dry-run mode; non-dry-run execution returns `unsupported_command`. `status` is reserved and unsupported.

## Operating Rules For Agents

The rest: https://github.com/krillinai/OpenCreator/blob/HEAD/skills/krillinai-cli/SKILL.md