Skip to main content
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 — every CLI command maps to an API call to api.vidjutsu.ai.

​
Install

curl -fsSL https://vidjutsu.ai/install.sh | bash
See installation for details and manual install options.

​
Commands

CommandDescription
vidjutsu authAuthenticate with your API key
vidjutsu watchAI watches video, freeform prompt
vidjutsu extractPull frames, audio, metadata via server-side processing
vidjutsu transcribeSpeech-to-text with word-level timing
vidjutsu checkValidate spec against rules
vidjutsu complianceScan a video or caption against platform TOS
vidjutsu uploadUpload media to CDN
vidjutsu accountCreate, list, get, or delete account records
vidjutsu postCreate, list, get, or delete post records
vidjutsu referenceCreate, list, get, edit, or delete reference records
vidjutsu assetCreate, list, get, edit, or delete asset records
vidjutsu usageRemaining daily capacity per endpoint
vidjutsu subscribeManage your subscription
vidjutsu infoShow API discovery info
vidjutsu sessionManage CLI sessions

​
Quick example

# 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: 
{
  "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.