π¦ ClawHub
Know your AI
by @juhengwu
Command-line tool for red-team AI security testing, running evaluations, detecting vulnerabilities, and reviewing detailed results via API integration.
TERMINAL
clawhub install know-your-aiπ About This Skill
---
name: know-your-ai
description: AI security testing & evaluation CLI. Run red-team evaluations, check vulnerabilities, and review results for your AI products.
homepage: https://knowyourai.hydrox.ai
requires:
bins:
- node
env:
- KNOW_YOUR_AI_DSN
primaryEnv: KNOW_YOUR_AI_DSN
metadata: {"clawdbot":{"emoji":"π‘οΈ","requires":{"bins":["node"],"env":["KNOW_YOUR_AI_DSN"]},"primaryEnv":"KNOW_YOUR_AI_DSN"}}
Know Your AI
AI security testing and evaluation CLI by HydroxAI. Run red-team evaluations, detect jailbreak vulnerabilities, and review security scores for your AI products β all from the command line.
Check setup
bash
node {baseDir}/scripts/doctor.mjs
Validates your DSN configuration and tests API connectivity. Requires KNOW_YOUR_AI_DSN environment variable.Show linked product & connection
bash
node {baseDir}/scripts/target.mjs
List evaluations and datasets
bash
node {baseDir}/scripts/list.mjs
Run an evaluation
bash
node {baseDir}/scripts/evaluate.mjs
Triggers an evaluation run and streams real-time progress. Returns scores, pass/fail counts, and the run ID.Options
--max-prompts : Maximum prompts per dataset (default: 3)
--timeout : Maximum wait time in seconds (default: 600)
--debug: Enable debug loggingView run history
bash
node {baseDir}/scripts/history.mjs
node {baseDir}/scripts/history.mjs --all
--all / -a: Show all runs (default: last 10)View results of a specific run
bash
node {baseDir}/scripts/result.mjs
Describe an evaluation
bash
node {baseDir}/scripts/describe.mjs
Shows detailed evaluation configuration: judge model, threshold, linked datasets, and prompt counts.Notes
Requires node (>=18) runtime
Requires KNOW_YOUR_AI_DSN environment variable from the Know Your AI dashboard (Settings β API Keys)
DSN format: https://kya_xxx:da2-xxx@host/product_id
Short alias kya is also available if installed globally via npm
Use doctor first to verify connectivity before running evaluations
Review detailed results in the Know Your AI dashboard after runs complete
βοΈ Configuration
--max-prompts : Maximum prompts per dataset (default: 3)--timeout : Maximum wait time in seconds (default: 600)--debug: Enable debug loggingπ Tips & Best Practices
node (>=18) runtimeKNOW_YOUR_AI_DSN environment variable from the Know Your AI dashboard (Settings β API Keys)https://kya_xxx:da2-xxx@host/product_idkya is also available if installed globally via npmdoctor first to verify connectivity before running evaluations