App commands
| Command | Behavior |
|---|---|
eyra | Start the live terminal session |
eyra menu | Launch the native macOS menu bar app when available |
eyra menu --json --check | Report menu bar availability, install mode, Swift requirement, and fallback command without launching |
eyra-menu | Launch the same menu bar app from the standalone console script |
eyra status | Show a short readiness, privacy, and service summary |
eyra setup | Create or repair local settings with guided provider setup |
eyra doctor | Check local AI, models, voice, microphone, screen capture, paths, and optional surfaces |
eyra doctor --json | Print the same support report in machine-readable form |
eyra start | Start the local Web control service in the background |
eyra stop | Stop the local Web control service started by Eyra |
eyra restart | Restart the local Web control service |
eyra open | Start and open the local Web UI |
eyra logs | Show app and Web service log paths without dumping log content |
eyra logs --open | Open the log folder in Finder |
eyra settings | List simple settings with secret values redacted |
eyra settings get <key> | Show one setting with its privacy note |
eyra settings set <key> <value> | Change one simple setting safely |
eyra memory status | Show compact local memory readiness |
eyra memory show | Show the compact memory summary |
eyra memory remember <text> | Save one durable fact as compact memory |
eyra memory forget <query> | Remove one matching memory fact |
eyra memory on|off | Enable or disable memory |
eyra memory path | Show the local memory file path |
eyra service status | Show local Web service state |
eyra service start | Start the local Web service |
eyra service stop | Stop the local Web service |
eyra service restart | Restart the local Web service |
eyra examples | Show useful first prompts and local workflows |
eyra certify | Run the local certification matrix |
eyra connectors validate | Validate connector manifests and print a redacted summary |
eyra connectors list | List configured connectors |
eyra connectors test <id> | Run one connector’s acceptance checks |
eyra web | Start the local Web UI |
eyra version | Show version, install source, commit, and Python version |
eyra paths | Show config, data, log, job, trigger, and command paths |
eyra update | Explain the right update command for this install source |
eyra uninstall --dry-run | Show what uninstall would remove while preserving local data |
Session commands
Session commands are controller-owned. They are intercepted before model routing and never sent to the model as ordinary chat.Session
| Command | Behavior |
|---|---|
/help | Show local command help |
/status | Show runtime status |
/capabilities | Show control surfaces and privacy boundary |
/context | Show goal, working directory, recent jobs, and recent changes |
/goal <text> | Set session context |
/memory status | Show memory readiness |
/memory show | Show compact memory |
/memory remember <fact> | Save a compact durable fact |
/memory forget <query> | Remove one matching memory fact |
/memory on|off | Enable or disable memory |
/memory path | Show the local memory file path |
/mode fast|balanced|best | Set quality mode |
/route last | Show the last routing trace when available |
/examples | Show useful first prompts and local workflows |
/clear | Reset conversation history |
/quit | Exit |
Voice
| Command | Behavior |
|---|---|
/voice on|off | Toggle voice input and speech output |
/handsfree on|off | Mark no-hands runtime intent |
/voice-diagnose | Run microphone, VAD, and Local Whisper diagnostics |
/voice-test | Start manual interruption diagnostics |
/mute | Mute speech output |
/unmute | Unmute speech output |
Tasks
| Command | Behavior |
|---|---|
/tasks | Show active and recent tasks |
/task <id> | Show detailed task state |
/task logs <id> | Show durable local job logs |
/task artifacts <id> | Show durable local job artifacts |
/task retry <id> | Retry a failed, cancelled, or blocked deterministic job |
/cancel <id> | Cancel one task |
/cancel all | Cancel all queued or running tasks |
/pause <id> | Pause a queued task |
/resume <id> | Resume a paused task |
/tasks clear-completed | Clear completed, failed, and cancelled rows |
Approvals
| Command | Behavior |
|---|---|
/approvals | Show pending risky-action approvals |
/approve <id> | Approve one exact action |
/reject <id> | Reject one exact action |
Connectors
| Command | Behavior |
|---|---|
/connectors | Show configured connectors and acceptance states |
/connector <id> | Show one connector’s type, risk, capabilities, privacy, and acceptance state |
/connector test <id> | Run the connector acceptance checks |
/connector enable <id> | Enable a connector for this session |
/connector disable <id> | Disable a connector for this session |
/connector run <id> <task> | Start a connector background job |
Local state
| Command | Behavior |
|---|---|
/operations | Show operation ledger entries |
/triggers | Show trigger definitions and status |
/trigger pause <id> | Pause a trigger |
/trigger resume <id> | Resume a trigger |
/trigger cancel <id> | Cancel a trigger |
Spoken equivalents
Eyra also handles common voice phrases locally:stopcancel thatpause thatresume thatshow statusremember that ...what do you rememberforget ...what are you doingwhat changedapprove thatreject thatlist connectorsshow connector <id>ask connector <id> to ...cancel connector <id>read the optionschoose number twostart dictationend dictation