CLI & npm

The Hinto CLI (@hintoai/cli) is a command-line client for the Hinto API. Use it from your terminal, in CI/CD pipelines, or from AI agents like Claude Code and Cursor.

npm: npmjs.com/package/@hintoai/cli GitHub: github.com/hintoai/hinto-cli

Installation

Requires Node.js 18+.

npm install -g @hintoai/cli

Authentication

Get your API key from the project in the Hinto app → Settings → API Keys & Webhooks → New API Key.

Run init once to store it:

hinto init --key hinto_your_key_here

Or set the environment variable (takes precedence over the stored key, useful in CI):

export HINTO_API_KEY=hinto_your_key_here

Quickstart

# 1. Upload a video
hinto videos upload --file ./demo.mp4 --json

# 2. List available templates
hinto templates article --json

# 3. Generate an article and wait for it to finish
hinto generate start --video <videoId> --template <templateId> --wait --json

# 4. Publish the project
hinto publish now --json

Key flags

Flag	Description
--json	Output raw JSON — use when scripting or chaining commands
--wait	Wait for async jobs to complete (supported on generate start and generate structure)
--api-url	Override the base URL (staging, self-hosted)

Shell completions

# bash — add to ~/.bashrc
eval "$(hinto completion bash)"

# zsh — add to ~/.zshrc
eval "$(hinto completion zsh)"

AI agent integration (Claude Code, Cursor, …)

Install the bundled skill into any supported agent:

npx skills add hintoai/hinto-cli

This installs the CLI itself on first use and gives your agent full access to all Hinto commands. See the GitHub README for the full command reference.