CLI Reference

CLI Reference

Use jarvis-line --help for the commands installed with your exact version. This page is a quick map; the repository's command reference contains detailed usage and output examples.

Command Map

Command	Purpose
jarvis-line setup	Guided, reviewed setup flow
jarvis-line init	Compatibility initializer with agent flags
jarvis-line doctor	Validate config, hooks, runtime, TTS, and updates
jarvis-line status	Show watcher, worker, queue, TTS, and speech mode
jarvis-line start	Start the watcher/runtime
jarvis-line stop	Stop watcher and worker processes
jarvis-line restart	Restart the local runtime
jarvis-line queue	Inspect or clear pending speech
jarvis-line logs	Show bounded watcher/worker logs
jarvis-line trace	Inspect privacy-safe lifecycle diagnostics
jarvis-line emit	Submit a versioned agent event
jarvis-line tts	Select, inspect, and test TTS backends
jarvis-line kokoro	Download, verify, and configure Kokoro assets
jarvis-line config	Read and modify configuration
jarvis-line instructions	Print or validate agent instruction blocks
jarvis-line install codex	Add or refresh Codex hooks
jarvis-line uninstall codex	Remove Jarvis Line Codex hooks
jarvis-line update	Check or apply an update
jarvis-line support-report	Create a redacted Markdown issue report
jarvis-line migrate-config	Migrate legacy config

Common Workflow

jarvis-line setup
jarvis-line install codex
jarvis-line doctor
jarvis-line start
jarvis-line tts test --text "Jarvis line test is ready."

Help

Top-level help:

jarvis-line --help

Subcommand help:

jarvis-line setup --help
jarvis-line config --help
jarvis-line tts --help
jarvis-line emit --help

Setup

Guided:

jarvis-line setup

Non-interactive default:

jarvis-line setup --default

Machine-readable setup is available to the macOS app and advanced integrations:

jarvis-line setup inspect --json

Runtime And Diagnostics

jarvis-line status
jarvis-line doctor
jarvis-line doctor --fix
jarvis-line queue status
jarvis-line queue clear
jarvis-line trace --limit 20
jarvis-line logs tail

TTS

jarvis-line tts capabilities
jarvis-line tts use system
jarvis-line tts use kokoro
jarvis-line tts test --text "Jarvis line test is ready."

Configuration

jarvis-line config get
jarvis-line config get attention_enabled
jarvis-line config get final_chime_enabled
jarvis-line config get final_chime_volume
jarvis-line config set attention_enabled false
jarvis-line config set final_chime_enabled false
jarvis-line config set final_chime_volume 0.6
jarvis-line config set volume 0.6
jarvis-line config contract

Agent Instructions

jarvis-line instructions print agents --language "English"
jarvis-line instructions print claude --language "English"
jarvis-line instructions print gemini --language "English"
jarvis-line instructions doctor agents

Explicit Events

jarvis-line emit \
  --source custom-agent \
  --session "session-123" \
  --phase final \
  --line "The requested change is complete."

Expected output:

Queued Jarvis Line event for custom-agent.

For an eligible final event, v0.8.3 plays the enabled completion chime before the spoken line. final_chime_volume controls this cue independently from TTS volume. Commentary and attention events do not play the cue.

Updates

jarvis-line update check
jarvis-line update apply

check only reports availability. apply installs from the configured source and ref. Run jarvis-line doctor and a TTS test afterward.

Support Report

jarvis-line support-report --output ./jarvis-line-issue.md

Open and review the Markdown before pasting relevant sections into a public issue. The command does not upload anything.