config
Project configuration — interactive setup, view, or update settings.
Running valiqor config with no subcommand launches the interactive wizard, which creates a .valiqorrc file in the current directory.
The wizard prompts for:
| Setting | Description |
|---|
project_name | Name for your Valiqor project |
trace_dir | Directory for trace output files |
scan_dir | Directory for scan output files |
environment | Environment label (e.g. development, production) |
valiqor config <show|set>
config show
Display current authentication info and local project settings.
valiqor config show [flags]
| Flag | Type | Default | Description |
|---|
--json | flag | false | Output as JSON |
# Human-readable output
valiqor config show
# Machine-readable output
valiqor config show --json
.valiqorrc settings, and the config file path.
config set
Update one or more settings non-interactively.
valiqor config set <key=value> [key=value ...]
project_name, api_key, trace_dir, scan_dir, environment, valiqor_intelligence, debug, openai_api_key
# Set multiple values at once
valiqor config set project_name=my-app environment=production
# Enable debug mode
valiqor config set debug=true
valiqor_intelligence, debug) accept true, 1, yes as truthy values. If trace_dir or scan_dir change, the CLI creates the new directories automatically.
status
Show a comprehensive status overview.
Displays:
- Authentication — credential source (global vs local), email
- Local config — project name, environment, directories
- Cloud connection — API reachability
- Files — trace and scan file counts in configured directories
- Modules — availability of Trace, Scanner, Eval, Security, Failure Analysis
- Version — installed SDK version
test
Validate that your project is correctly configured and can reach the Valiqor backend.
Checks:
- Trace and scan directories exist and are writable
- API key is valid (local or global)
- Backend API is reachable
- Required modules are installed
- Provider packages detected (openai, anthropic, langchain, ollama, agno)
Reports errors and warnings with actionable messages.
upload
Upload trace and scan files to the Valiqor backend.
valiqor upload [path] [flags]
| Flag | Type | Default | Description |
|---|
path | positional | configured dirs | Path to a file or directory to upload |
-t / --type | trace | scan | all | all | Type of files to upload |
--endpoint | string | — | Custom backend API endpoint URL |
--api-key | string | — | API key override |
--delete-after | flag | false | Delete local files after successful upload |
--dry-run | flag | false | Show what would be uploaded without uploading |
Examples
# Upload everything from configured directories
valiqor upload
# Upload a specific trace file
valiqor upload ./traces/run_001.json --type trace
# Preview what would be uploaded
valiqor upload --dry-run
# Upload and clean up local files
valiqor upload --delete-after
Without an explicit path, the CLI uploads from the directories configured in .valiqorrc (trace_dir and scan_dir).
