Skip to main content
The Tuteliq CLI lets you test safety endpoints, analyze files, and manage API keys directly from the terminal. It’s built for developers who want to prototype and debug without writing code.

​
Installation

npm install -g @tuteliq/cli
Or with Homebrew: 
brew install tuteliq/tap/tuteliq

​
Authentication

Set your API key: 
tuteliq auth login
Or pass it as an environment variable: 
export TUTELIQ_API_KEY=your_api_key

​
Detect unsafe content

Analyze a text string: 
tuteliq detect unsafe "Let's meet at the park after school, don't tell your parents" --age-group 10-12
Output: 
{
  "safe": false,
  "severity": "high",
  "categories": ["grooming", "secrecy"],
  "risk_score": 87,
  "rationale": "Message contains secrecy request and meeting solicitation..."
}

​
Detect grooming patterns

Analyze a conversation from a JSON file: 
tuteliq detect grooming --file conversation.json --age-group 10-12
Where conversation.json contains: 
{
  "messages": [
    { "role": "stranger", "text": "Hey, how old are you?" },
    { "role": "child", "text": "I'm 11" },
    { "role": "stranger", "text": "Cool. Do you have your own phone?" },
    { "role": "stranger", "text": "Let's talk on a different app, just us" }
  ]
}

​
Analyze emotions

tuteliq analyze emotions "Nobody at school talks to me anymore. I just sit alone every day." --age-group 13-15

​
Analyze voice

Analyze an audio file: 
tuteliq analyze voice recording.wav --age-group 13-15

​
Analyze image

Analyze an image file: 
tuteliq analyze image screenshot.png --age-group 10-12

​
Fraud detection

Detect social engineering, app fraud, romance scams, and mule recruitment. 
# Detect social engineering
tuteliq detect social-engineering "If you really trusted me you'd send your address" --age-group 10-12

# Detect romance scam
tuteliq detect romance-scam "You're so mature for your age. Keep us a secret." --age-group 13-15

# Detect app fraud
tuteliq detect app-fraud "Download this app and enter your parent's card details" --age-group 10-12

# Detect mule recruitment
tuteliq detect mule-recruitment "I just need you to receive some money in your account" --age-group 13-15

​
Safety extended

Detect gambling harm, coercive control, vulnerability exploitation, and radicalisation. 
# Detect gambling harm
tuteliq detect gambling-harm "I know a way to get free V-Bucks, just put in your card" --age-group 10-12

# Detect coercive control
tuteliq detect coercive-control "You're not allowed to talk to anyone else. Only me." --age-group 13-15

# Detect vulnerability exploitation
tuteliq detect vulnerability-exploitation "I know your parents don't listen. I actually care about you." --age-group 13-15

# Detect radicalisation
tuteliq detect radicalisation "They're all against us. Only our group understands the truth." --age-group 13-15

​
Multi-endpoint analysis

Run multiple detections on a single text in one command. 
tuteliq detect multi "You're so special. Send me a photo." \
  --endpoints social-engineering,grooming,romance-scam \
  --age-group 13-15
Output: 
{
  "summary": {
    "overall_risk_level": "high",
    "detected_count": 2,
    "total_endpoints": 3
  },
  "results": [
    { "endpoint": "social-engineering", "detected": false, "risk_score": 0.2 },
    { "endpoint": "grooming", "detected": true, "risk_score": 0.87 },
    { "endpoint": "romance-scam", "detected": true, "risk_score": 0.91 }
  ]
}

​
Analyze video

Analyze a video file for safety concerns. 
tuteliq analyze video clip.mp4 --age-group 13-15
Output: 
{
  "frames_analyzed": 24,
  "overall_risk_score": 0.65,
  "overall_severity": "medium",
  "safety_findings": [
    { "frame_index": 12, "timestamp": 4.5, "description": "...", "severity": 0.7 }
  ]
}

​
Batch processing

Analyze multiple inputs from a file: 
tuteliq batch detect unsafe --file messages.jsonl --age-group 13-15 --output results.jsonl
Batch mode processes inputs in parallel and writes results as newline-delimited JSON (JSONL).

​
Output formats

Control output format with --format: 
# JSON (default)
tuteliq detect unsafe "text" --format json

# Table view
tuteliq detect unsafe "text" --format table

# Minimal (just severity)
tuteliq detect unsafe "text" --format minimal

​
API key management

# View current key info
tuteliq auth status

# Check credit balance
tuteliq usage

# Rotate key
tuteliq auth rotate

​
Configuration

View and set defaults: 
# Set default age group
tuteliq config set age-group 13-15

# Set default output format
tuteliq config set format table

# View all settings
tuteliq config list

​
All commands

CommandDescription
tuteliq detect unsafeDetect unsafe content in text
tuteliq detect bullyingDetect bullying in text
tuteliq detect groomingDetect grooming in conversations
tuteliq detect social-engineeringDetect social engineering tactics
tuteliq detect app-fraudDetect app-based fraud patterns
tuteliq detect romance-scamDetect romance scam patterns
tuteliq detect mule-recruitmentDetect money mule recruitment
tuteliq detect gambling-harmDetect gambling harm indicators
tuteliq detect coercive-controlDetect coercive control patterns
tuteliq detect vulnerability-exploitationDetect vulnerability exploitation
tuteliq detect radicalisationDetect radicalisation indicators
tuteliq detect multiRun multiple detections on one text
tuteliq analyze emotionsAnalyze emotional well-being
tuteliq analyze voiceAnalyze audio files
tuteliq analyze imageAnalyze image files
tuteliq analyze videoAnalyze video files
tuteliq batchBatch-process multiple inputs
tuteliq authManage API key authentication
tuteliq usageView credit balance and usage
tuteliq configView and set CLI configuration

​
Next steps

API Reference

Explore the full API specification.

Node.js SDK

See the Node.js SDK guide.