Headless Mode

Usage

wilson --run "<query>"

Runs a single AI query without the interactive TUI. Wilson processes the query, executes any necessary tools, and prints the result to stdout.

Examples

# Quick spending check
wilson --run "How much did I spend on dining this month?"

# Generate a summary
wilson --run "Give me a spending summary for last month"

# Find anomalies
wilson --run "Are there any duplicate charges or unusual transactions?"

# Run a skill
wilson --run "Run the subscription audit skill"

Scripting

Combine with other CLI commands:

# Import and summarize
wilson --run "Import transactions from ~/Downloads/chase.csv" && \
wilson --summary month

# Daily import via cron
0 9 * * * cd ~/wilson && bun start --run "Import ~/Downloads/latest.csv"

Output

Headless mode prints the AI’s final answer to stdout. Tool execution details are suppressed. Use --status or --summary for structured reports instead of --run when you need predictable output formats.

Combining with Report Commands

For automated reporting, prefer the dedicated report flags over --run:

# Weekly spending email
wilson --summary week --offset 0 > /tmp/weekly.txt && \
  mail -s "Weekly Spending" you@email.com < /tmp/weekly.txt

# Monthly P&L export
wilson --pnl month --offset 1 > ~/reports/pnl-$(date +%Y-%m).txt