Skip to main content
RCLI provides a comprehensive CLI for voice AI interaction, document querying, model management, and system benchmarking. All commands run 100% locally on Apple Silicon.

​
Quick Reference

CommandDescription
rcliInteractive TUI mode (push-to-talk + text)
rcli listenContinuous voice mode (always listening)
rcli ask <text>One-shot text command
rcli actions [name]List or inspect macOS actions
rcli rag <sub>RAG: ingest, query, status
rcli modelsManage LLM/STT/TTS models
rcli voicesManage TTS voices
rcli upgrade-llmDownload larger LLM
rcli upgrade-sttUpgrade to Parakeet TDT
rcli benchRun performance benchmarks
rcli setupDownload AI models (~1GB)
rcli infoShow engine and model info
rcli cleanupRemove unused models

​
Global Options

These options work with most commands:
​
--models
string
default:"~/Library/RCLI/models"
Models directory path
​
--rag
string
Load RAG index for document-grounded answers
​
--gpu-layers
number
default:"99"
GPU layers for LLM (99 = all layers, 0 = CPU only)
​
--ctx-size
number
default:"4096"
LLM context window size
​
--no-speak
boolean
Disable TTS audio output (text only)
​
--verbose
boolean
Enable debug logs from engines

​
Examples by Use Case

​
Voice Control

# Interactive mode with push-to-talk
rcli

# Hands-free continuous listening
rcli listen

# One-shot voice command via text
rcli ask "open Safari"

​
Document Intelligence (RAG)

# Index documents for Q&A
rcli rag ingest ~/Documents/notes

# Query indexed documents
rcli rag query "What were the key decisions?"

# Use RAG in interactive mode
rcli --rag ~/Library/RCLI/index

​
Model Management

# Browse and switch models
rcli models

# Manage TTS voices
rcli voices

# Upgrade to better STT model
rcli upgrade-stt

# Free up disk space
rcli cleanup

​
Benchmarking

# Run all benchmarks
rcli bench

# Benchmark specific suite
rcli bench --suite llm

# Compare all installed LLMs
rcli bench --all-llm --suite llm

# Export results to JSON
rcli bench --output results.json

​
Command Categories

Interactive Mode

Push-to-talk TUI with keyboard shortcuts

Listen Mode

Continuous voice activation

Text Commands

One-shot text queries with rcli ask

RAG Commands

Document ingestion and querying

Model Management

Switch and download AI models

Benchmarking

Performance testing across all subsystems

​
Return Codes

  • 0 — Success
  • 1 — Error (check stderr for details)

​
Environment Variables

  • HOME — Used to locate ~/Library/RCLI/ config and index directories
  • COLORFGBG — Detected for TUI theme (light/dark mode)

Build docs developers (and LLMs) love

Get started for freeTalk to us