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
brew install tuteliq/tap/tuteliq
Authentication
Set your API key:
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
{
"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
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
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).
--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
| Command | Description |
|---|
tuteliq detect unsafe | Detect unsafe content in text |
tuteliq detect bullying | Detect bullying in text |
tuteliq detect grooming | Detect grooming in conversations |
tuteliq analyze emotions | Analyze emotional well-being |
tuteliq analyze voice | Analyze audio files |
tuteliq analyze image | Analyze image files |
tuteliq batch | Batch-process multiple inputs |
tuteliq auth | Manage API key authentication |
tuteliq usage | View credit balance and usage |
tuteliq config | View and set CLI configuration |
Next steps
