README.md

# Kling AI — Skills-only for local Codex

Version **1.1.2** uses the official Global CLI **0.2.1**. This plugin registers no MCP server or ChatGPT app. It requires local shell access, Node.js 18+, and npm; ChatGPT web Work cannot run this local CLI workflow.

Codex uses this pinned prefix without a global install:

```bash
npm exec --yes --registry=https://registry.npmjs.org --package=@klingai/cli-global@0.2.1 -- kling <command>
```

npm may download and execute the package. Codex explains this dependency before first use and respects execution approvals. The CLI owns service configuration and browser OAuth: Codex runs `login` when needed, the user completes consent, and `who_am_i` verifies identity. Never paste credentials or manually configure an MCP connection. Switching regional plugins requires logging out through the old region's CLI first.

## Skills and supported workflows

- `$kling-ai`: account, credits, Elements, motions, uploads, feedback, and task lifecycle.
- `$kling-ai-generate-image`: text images, reference editing, products, posters, and controlled variants.
- `$kling-ai-generate-video`: standard video, keyframes, `omni_ref_video`, motion transfer, audio, and shot planning.

Models and specifications come from `tool_list` and `who_am_i`. Always use `--model`; CLI 0.2.1 removed `--omni` and `--flash`. Mixed-reference video uses the separate `omni_ref_video` command, with supported image/video/audio or named input flags. A server tool alone does not imply a supported CLI command or an available model.

Prefer conversation attachments. The CLI auto-uploads local resource paths through supported flags; standalone `file_upload` is reserved for explicit upload requests. Review final settings before paid submission, check `account`, and submit each confirmed step at most once. Poll only the accepted task, without automatic retries. Return result links from successful works; no widget is assumed. A task number or video cover does not establish completion.

## Validation and distribution

Use the repository `scripts/workflow.sh` for the applicable gates. In this directory, `npm run check`, `npm test`, and `npm run pack:release` validate source, negative fixtures, and the unpacked ZIP. Node.js 20+ is required for these development scripts, distinct from the CLI runtime's Node.js 18+ requirement.

The ZIP includes only the plugin manifest, three Skills and references, icon, README, and license. It excludes MCP/App configuration and development dependencies. Real login, credits, upload, and paid generation need separate acceptance; local validation does not perform them.

MIT. Kling AI marks belong to their respective owners.