Skip to main content
RCLI provides a comprehensive set of commands for voice interaction, text processing, model management, and system configuration.

​
Interactive Mode

​
rcli
command
Launch the full-screen interactive TUI with push-to-talk, live hardware monitoring, and model management.
rcli
Features:
  • Push-to-talk voice recording (press SPACE)
  • Text input mode
  • Real-time hardware metrics
  • Model hot-swapping
  • Action browser
  • Benchmark runner
  • RAG document ingestion
Keyboard Shortcuts:
  • SPACE - Start/stop voice recording
  • M - Models panel (browse, download, switch LLM/STT/TTS)
  • A - Actions panel (enable/disable macOS actions)
  • B - Benchmarks panel
  • R - RAG panel
  • D - Cleanup panel (delete unused models)
  • T - Toggle tool call trace
  • ESC - Stop processing / close panel / quit

​
Voice Commands

​
rcli listen
command
Continuous voice mode - always listening for commands.
rcli listen
RCLI continuously monitors your microphone, detects speech, processes commands, and responds via TTS. Press Ctrl+C to stop.Example use case: Leave running in the background for hands-free Mac control.

​
Text Commands

​
rcli ask
command
Execute a one-shot text command without voice input.
rcli ask "<your question or command>"
Examples:
rcli ask "open Safari"
rcli ask "create a note called Meeting Notes"
rcli ask "play some jazz on Spotify"
rcli ask "what is the capital of France?"
rcli ask "set volume to 50"
RAG-enhanced queries:
rcli ask --rag ~/Library/RCLI/index "summarize the project plan"

​
Actions Management

​
rcli actions
command
List all 43 available macOS actions.
rcli actions
Display all actions grouped by category (Productivity, Communication, Media, System, Window, Web/Nav, Clipboard).
​
rcli actions [name]
command
Show detailed information for a specific action.
rcli actions open_app
​
rcli action
command
Execute an action directly with JSON arguments.
rcli action <action_name> <json_args>
Examples:
rcli action open_app '{"app_name": "Safari"}'
rcli action set_volume '{"level": 50}'
rcli action create_note '{"title": "Ideas", "content": "My brilliant idea"}'

​
Model Management

​
rcli models
command
Interactive model management dashboard for all AI models.
rcli models              # All models
rcli models llm          # Jump to LLM management
rcli models stt          # Jump to STT management
rcli models tts          # Jump to TTS management
Browse, download, and switch between models without restarting RCLI.
​
rcli voices
command
Browse, download, and switch TTS voices.
rcli voices
Interactive picker for 6 TTS voices (Piper, KittenTTS, Kokoro, Matcha).
​
rcli upgrade-llm
command
Guided LLM upgrade wizard.
rcli upgrade-llm
Download and switch to a larger, more capable language model (Qwen3.5 2B/4B, LFM2 2.6B).
​
rcli upgrade-stt
command
Upgrade to Parakeet TDT high-accuracy STT.
rcli upgrade-stt
Downloads NVIDIA Parakeet TDT 0.6B v3 (~640MB) for ~1.9% WER (vs. Whisper’s ~5% WER).

​
RAG (Document Intelligence)

​
rcli rag ingest
command
Index documents for retrieval-augmented generation.
rcli rag ingest <directory>
Examples:
rcli rag ingest ~/Documents/notes
rcli rag ingest ~/Projects/my-app/docs
Supports PDF, DOCX, and plain text files. Creates a hybrid index (vector + BM25) in ~/Library/RCLI/index.
​
rcli rag query
command
Query indexed documents.
rcli rag query "<your question>"
Example:
rcli rag query "What were the key decisions in the project plan?"
​
rcli rag status
command
Show RAG index information.
rcli rag status

​
Benchmarking

​
rcli bench
command
Run comprehensive benchmarks across all subsystems.
rcli bench [options]
Suite options:
  • all - Run all benchmarks (default)
  • stt - Speech-to-text only
  • llm - Language model only
  • tts - Text-to-speech only
  • e2e - End-to-end pipeline
  • tools - Tool-calling accuracy and latency
  • rag - RAG retrieval performance
  • memory - Memory usage profiling
Examples:
rcli bench
rcli bench --suite llm
rcli bench --suite tools --runs 5
rcli bench --all-llm --suite llm          # Compare all installed LLMs
rcli bench --all-llm --suite tools        # Tool-calling comparison
rcli bench --output results.json          # Export to JSON
rcli bench --rag ~/Library/RCLI/index --suite rag

​
System Commands

​
rcli setup
command
Download default models (~1GB one-time setup).
rcli setup
Downloads:
  • LFM2 1.2B Tool (LLM)
  • Zipformer (streaming STT)
  • Whisper base.en (offline STT)
  • Piper Lessac (TTS)
  • Silero VAD
  • Snowflake Arctic Embed S (embeddings)
​
rcli cleanup
command
Remove unused models to free disk space.
rcli cleanup
Interactive tool to identify and delete models not currently selected.
​
rcli info
command
Display engine information and installed models.
rcli info
Shows active models, hardware profile, and system configuration.
​
rcli mic-test
command
Test microphone audio levels.
rcli mic-test
Records for 5 seconds and displays live audio level visualization. Useful for debugging microphone issues.

​
Help

​
rcli --help
command
Display command reference.
rcli --help
rcli listen --help
rcli ask --help
rcli bench --help

​
Exit Codes

  • 0 - Success
  • 1 - Error (missing models, initialization failure, invalid arguments)

Options

Command-line flags and parameters

Environment

Environment variables and config files

Build docs developers (and LLMs) love

Get started for freeTalk to us