> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidjutsu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> The VidJutsu command-line interface

The VidJutsu CLI lets you run intelligence calls and manage your content library from the terminal. It's a lightweight wrapper around the [REST API](/api-reference/introduction) — every CLI command maps to an API call to `api.vidjutsu.ai`.

## Install

```bash theme={null}
curl -fsSL https://vidjutsu.ai/install.sh | bash
```

See [installation](/cli/install) for details and manual install options.

## Commands

| Command                                  | Description                                             |
| ---------------------------------------- | ------------------------------------------------------- |
| [`vidjutsu auth`](/cli/auth)             | Authenticate with your API key                          |
| [`vidjutsu watch`](/cli/watch)           | AI watches video, freeform prompt                       |
| [`vidjutsu extract`](/cli/extract)       | Pull frames, audio, metadata via server-side processing |
| [`vidjutsu transcribe`](/cli/transcribe) | Speech-to-text with word-level timing                   |
| [`vidjutsu check`](/cli/check)           | Validate spec against rules                             |
| [`vidjutsu compliance`](/cli/compliance) | Scan a video or caption against platform TOS            |
| [`vidjutsu upload`](/cli/upload)         | Upload media to CDN                                     |
| [`vidjutsu account`](/cli/accounts)      | Create, list, get, or delete account records            |
| [`vidjutsu post`](/cli/posts)            | Create, list, get, or delete post records               |
| [`vidjutsu reference`](/cli/references)  | Create, list, get, edit, or delete reference records    |
| [`vidjutsu asset`](/cli/assets)          | Create, list, get, edit, or delete asset records        |
| [`vidjutsu usage`](/cli/usage)           | Remaining daily capacity per endpoint                   |
| [`vidjutsu subscribe`](/cli/subscribe)   | Manage your subscription                                |
| [`vidjutsu info`](/cli/info)             | Show API discovery info                                 |
| [`vidjutsu session`](/cli/session)       | Manage CLI sessions                                     |

## Quick example

```bash theme={null}
# Authenticate
vidjutsu auth --key vj_live_xxxx

# Watch a video
vidjutsu watch --video-url "https://cdn.example.com/video.mp4" --prompt "Is the hook effective?"

# Extract frames and audio
vidjutsu extract --video-url "https://cdn.example.com/video.mp4" --frames auto --audio

# Transcribe speech
vidjutsu transcribe --video-url "https://cdn.example.com/video.mp4"

# Validate a spec
vidjutsu check --spec ./brief.json --rules "hook-required,max-duration-60s"

# Create an account record
vidjutsu account create --platform instagram --name "style_la" --niche "fashion"
```

## Configuration

The CLI stores its config at `~/.vidjutsu/config.json`:

```json theme={null}
{
  "apiUrl": "https://api.vidjutsu.ai",
  "apiKey": "vj_live_xxxx"
}
```

All output is JSON by default, making it easy to pipe into `jq` or other tools.