Commands Reference
Complete reference for all AskVerdict CLI commands: debate, list, view, stream, delete, and more.
Global Options
All commands accept these flags:
| Flag | Description |
|---|---|
--token <key> | Override API key for this command |
--api-url <url> | Override API base URL |
--json | Output as JSON (for piping) |
--help | Show help for the command |
debate
Create a new debate and optionally stream results.
askverdict debate "Should we adopt Kubernetes?" --mode thorough| Flag | Default | Description |
|---|---|---|
--mode <mode> | balanced | Debate mode: fast, balanced, thorough |
--context <text> | — | Additional context |
--stream | false | Stream events in real-time |
--tags <tags> | — | Comma-separated tags |
Examples:
# Quick debate
askverdict debate "Should I use Redis or Memcached?" --mode fast
# Thorough with context and streaming
askverdict debate "Should we acquire CompanyX?" \
--mode thorough \
--context "CompanyX has 50 employees, $5M ARR" \
--stream
# With tags
askverdict debate "Rust vs Go for CLI tools" --tags "languages,tools"list
List your debates with filtering.
askverdict list --status completed --limit 10| Flag | Default | Description |
|---|---|---|
--status <status> | — | Filter: pending, running, completed, failed |
--limit <n> | 20 | Number of results |
--page <n> | 1 | Page number |
view
View a specific debate and its verdict.
askverdict view dbt_abc123Displays the full debate including arguments, rebuttals, and verdict.
stream
Stream events for a running debate.
askverdict stream dbt_abc123Shows real-time events as the debate unfolds. Automatically exits when the debate completes.
delete
Delete a debate.
askverdict delete dbt_abc123Prompts for confirmation unless --force is passed.
config
Manage CLI configuration.
# Set a config value
askverdict config set api-key vrd_your_key
askverdict config set default-mode thorough
# Get a config value
askverdict config get api-key
# Show all config
askverdict config listwhoami
Show your authenticated user profile.
askverdict whoamisearch
Search across your debates.
askverdict search "kubernetes" --limit 5stats
Show your usage statistics.
askverdict statsexport
Export debates in various formats.
askverdict export dbt_abc123 --format markdown
askverdict export dbt_abc123 --format json| Flag | Default | Description |
|---|---|---|
--format <fmt> | markdown | Export format: markdown, json, csv |
health
Check API health status.
askverdict healthoutcomes
Manage debate outcomes (track decisions).
# List pending outcomes
askverdict outcomes --pending
# Record an outcome
askverdict outcomes record dbt_abc123 --result "Adopted Kubernetes, went well"Was this page helpful?