Eyra starts with preflight, then runs one live session until you quit. Typed and spoken input feed the same conversation and the same local policy router. 
eyra
If you prefer visible controls first, run: 
eyra menu
The menu bar can open a terminal session, start the local Web control UI, run setup, run doctor, open logs, and toggle simple voice/privacy settings. Expected startup: 
Eyra

  Voice: input + speech    Backend: ready

  Type anything or speak. /help for commands.

​
Preflight

Startup checks run in this order:
  1. Backend reachability through /v1/models, with Ollama /api/tags fallback.
  2. Model availability for MODEL, VISION_MODEL, worker model, and routing tiers when enabled.
  3. Local Whisper availability when voice input or speech output is enabled.
  4. macOS screen capture command availability.
The session does not start until backend and model checks pass. USE_MOCK_CLIENT=true skips backend and model checks for local development.

​
Input

Typed input uses prompt_toolkit. Voice input uses sounddevice, Silero VAD, and Local Whisper. Eyra pauses listening while it is thinking or speaking so the microphone does not fight the response stream.

​
Local commands

Commands starting with / are handled by the controller and never sent to the model. Common commands: 
/help
/status
/capabilities
/context
/tasks
/operations
/voice on
/voice off
/quit
Full list: Commands.

​
Good first prompts

You do not need special wording. Plain requests are fine: 
What can you control?
Are you local right now?
What would leave my machine?
Show status.
Help me check if setup is ready.
Move the latest downloaded file to Documents.
Start dictation.
End dictation.
Remind me in 10 minutes to stand up.
Run /examples inside Eyra or eyra examples from the shell whenever you want a quick list of useful local workflows.

​
What Eyra records

Eyra records durable local state for work that needs recovery:
  • Background task metadata, logs, artifacts, result, error, and cancellation state.
  • Operation ledger entries for local computer-changing actions.
  • Trigger definitions and status.
  • Current goal and context snapshot in runtime memory.
Default stores live under ~/.local/share/eyra/ unless you change the settings.