Command reference

Built-in commands 294

The commands that ship in commands.json, grouped by pack. Packs can be switched on and off in Settings → Tools → Command library.

3D printer 8

Status and control for a FlashForge printer on your network. plugins/commands/flashforge_printer.py

• “cancel print”“abort print”“cancel printing”“stop print”“stop printing” [flashforge_printer.cancel_print]

  Cancels the print the printer is running.

  can delete or close things

• “list print files”“available prints”“printer files”“show print files”“what can i print” [flashforge_printer.list_print_files]

  Reads out the files stored on the printer.

  reads information

• “pause print”“hold the print”“pause printing”“pause the print” [flashforge_printer.pause_print]

  Pauses the print the printer is running.

• “print me a gun”“3d print a gun”“print a gun”“print me a weapon”“three d print a gun” [flashforge_printer.print_me_a_gun]

  Opens the toy gun model and wakes the printer up.

• “printer light”“chamber light”“printer lamp”“toggle printer light”“turn on printer light” [flashforge_printer.printer_light]

  Turns the printer's chamber light on or off.

• “printer status”“check the printer”“how is the print”“is the printer done”“print progress”“print status”“printer state” [flashforge_printer.printer_status]

  Reads out the printer's state, temperatures and progress.

• “resume print”“continue print”“continue printing”“resume printing” [flashforge_printer.resume_print]

  Resumes the print you paused.

• “start print”“begin print”“begin printing”“print file”“start printing” [flashforge_printer.start_print]

  Starts printing the file you name.

  can delete or close things then say: text (optional)

Alarms 6

Mark, enable, disable and read your alarms. plugins/commands/alarm_commands.py

• “complete alarm”“alarm complete”“alarm done”“i did it” [alarm_commands.complete_alarm]

  Marks the alarm you name as done for today.

  changes something

• “disable alarm”“turn off alarm” [alarm_commands.disable_alarm]

  Turns the alarm you name off, so it will not sound.

  changes something then say: alarm name (optional)

• “dismiss alarm”“quiet alarm”“skip alarm”“snooze alarm” [alarm_commands.dismiss_alarm]

  Silences the alarm that is going off now.

• “enable alarm”“turn on alarm” [alarm_commands.enable_alarm]

  Turns the alarm you name back on, so it will sound again.

  changes something then say: alarm name (optional)

• “read alarms”“list alarms”“what alarms do i have” [alarm_commands.read_alarms]

  Reads out the alarms you have set.

  reads information

• “show alarms”“alarm overview”“alarm status” [alarm_commands.show_alarms]

  Puts your alarms on the screen.

Ask GPT or Claude 2

Questions answered by your own GPT or Claude subscription command line. Added after v0.30.0-beta.2. plugins/commands/ask_agent.py

• “ask gpt”“ask codex” [ask_agent.ask_gpt]

  Asks GPT, through the Codex command line you are signed in to, the question you say next. Read-only by default; the first sixty words of the answer are spoken.

  then say: text (optional)

• “new conversation with” [ask_agent.new_conversation_with]

  Starts a fresh conversation: say new conversation with gpt, or with claude.

  then say: text (optional)

Ava 8

The assistant: its mode switches, routes, memory commands and questions. plugins/commands/ask_ollama.py

• “ava cancel”“ava stop”“cancel that ava” [ask_ollama.ava_cancel]

  Cancels everything Ava is doing, including anything queued or repeating.

• “ava cloud”“cloud mode”“use cloud” [ask_ollama.ava_cloud]

  Switches Ava to the cloud model, which sends your requests to your provider.

• “ava forget”“clear memory”“forget conversation”“start over ava” [ask_ollama.ava_forget]

  Clears what Ava remembers of this conversation.

• “ava local”“local mode”“use local” [ask_ollama.ava_local]

  Switches Ava back to the local model, so nothing leaves the machine.

• “hey ava”“ask ava”“ava”“samsara think”“think about”“what do you think” [ask_ollama.hey_ava]

  Asks Ava the question that follows, out loud.

  then say: text (optional) say it on its own

• “is it safe to”“is it okay to”“should i” [ask_ollama.is_it_safe_to]

  Asks Ava whether an action you describe is safe before you do it.

  then say: text (optional)

• “stop schedule”“ava stop schedule”“cancel schedule”“stop repeating”“stop timer” [ask_ollama.stop_schedule]

  Stops any repeating task Ava is running.

• “yes”“confirm it”“do it”“go ahead”“sure”“yeah”“yeah do it”“yep”“yup” [ask_ollama.yes]

  Confirms the action Ava has just asked you about.

Claude desktop 5

Draft, confirm and send a message in the Claude desktop app. plugins/commands/message_claude.py

• “claude message prepare”“ask claude”“message claude”“send claude”“tell claude” [message_claude.claude_message_prepare]

  Drafts a message to the Claude desktop app and asks you to confirm.

  changes something then say: text (optional)

• “claude message submit” [message_claude.claude_message_submit]

  Sends the message you had prepared for Claude.

  can delete or close things then say: remainder

• “read the rest” [message_claude.read_the_rest]

  Speaks the next part of the last Claude, GPT or queue reply.

• “repeat that” [message_claude.repeat_that]

  Repeats the last spoken reply.

• “stop claude”“quiet claude”“stop claude reply”“stop the reply” [message_claude.stop_claude]

  Stops Claude's reply being read aloud.

Demo commands 9

Show-off commands used in the demonstration. plugins/commands/demo_commands.py

• “archive my tabs”“save all tabs”“save my tabs” [demo_commands.archive_my_tabs]

  Bookmarks every open browser tab and then closes them.

• “clear explosions”“clean up explosions”“remove explosions” [demo_commands.clear_explosions]

  Clears the explosion overlays from the screen.

  can delete or close things

• “explode wubbys balls”“explode his balls”“explode movies balls”“explode what these balls”“explode woeys balls”“explode woobies balls”“explode wubbies balls”“explode wubby”“wubby explosion” [demo_commands.explode_wubbys_balls]

  Draws an explosion at a random spot on the screen.

• “fucking stop”“make it stop”“shut it all down”“stop everything” [demo_commands.fucking_stop]

  Stops all media, turns the lights off and silences everything.

• “move all that over”“clear my screen”“move all that over there”“move everything over”“sweep it over” [demo_commands.move_all_that_over]

  Moves every window from the main screen to the one on the right.

• “resume workflow”“open my work stuff”“open work”“resume work”“work mode” [demo_commands.resume_workflow]

  Opens a spread of work apps, for demonstrating the app.

• “show me celery man”“celery man”“celeryman”“show me celeryman” [demo_commands.show_me_celery_man]

  Minimises everything and plays the Celery Man clip fullscreen.

  reads information

• “wake me up”“wake me the fuck up” [demo_commands.wake_me_up]

  Gas Gas Gas + screen flash + Hyperion strobe + batman + mariachi.

• “what was i working on”“what was i doing”“where was i” [demo_commands.what_was_i_working_on]

  Plays a scripted joke reply, for demonstrating the app.

  reads information

Example plugin 1

A tiny plugin that shows how a command is written. plugins/commands/example_greet.py

• “greet me”“hello”“say hello” [example_greet.greet_me]

  Prints a greeting, as an example of how a plugin command works.

Find a browser tab 3

Switch to a tab by what it says, or find text on a page. plugins/commands/tab_finder.py

• “find tab”“find my”“find the tab”“switch to tab”“where is” [tab_finder.find_tab]

  Finds the browser tab matching what you say and switches to it.

  then say: query (optional) only in: brave, chrome, firefox, msedge, opera, vivaldi

• “find text”“find” [tab_finder.find_text]

  Open the browser find bar and enter the requested page text.

  then say: remainder only in: brave, chrome, firefox, msedge, opera, vivaldi

• “tab number”“tab” [tab_finder.tab_number]

  Switch to browser tab 1 through 8; tab 9 means the last tab.

  then say: remainder only in: brave, chrome, firefox, msedge, opera, vivaldi

GIF search 1

Find a GIF by describing it. plugins/commands/gif_search.py

• “search for a gif of”“find a gif of”“find me a gif of”“get me a gif of”“gif me”“gif of”“look up a gif of”“search gif” [gif_search.search_for_a_gif_of]

  Searches Giphy for a GIF of whatever you say next.

  then say: text (optional)

Hands-free session 1

Commands that belong to a Hands-Free session. plugins/commands/session_mode_commands.py

• “retype that”“retype it”“retype last” [session_mode_commands.retype_that]

  Types the last thing Samsara held back because the window had changed.

Health log 8

Log how you feel and export the record. plugins/commands/health_tracker.py

• “clear health log”“delete health log”“reset health log”“wipe health log” [health_tracker.clear_health_log]

  Deletes every entry in your health log.

  can delete or close things

• “export health log”“download health log”“export health”“health csv”“save health log” [health_tracker.export_health_log]

  Saves your whole health log to a CSV file.

  changes something

• “health summary”“health report”“how am i doing”“how am i feeling”“how is my pain”“how was my day”“how was my week”“hows my pain”“pain summary” [health_tracker.health_summary]

  Reads out a summary of what you have logged recently.

  reads information then say: text (optional)

• “pain level”“log pain”“my pain is”“pain at”“pain is” [health_tracker.pain_level]

  Logs a pain level, such as pain level six, with an optional place.

  changes something then say: remainder (optional)

• “read health log”“health entries”“health log”“read health”“read my health”“what did i log” [health_tracker.read_health_log]

  Reads out what you have logged today.

  reads information

• “symptom”“i feel”“im feeling”“log symptom”“symptoms” [health_tracker.symptom]

  Logs a symptom in your own words.

  changes something then say: remainder (optional)

• “took”“just took”“log med”“log medication”“medication”“popped”“popped a”“take” [health_tracker.took]

  Logs a medication you have just taken.

  changes something then say: remainder (optional)

• “undo health log”“delete last health”“remove last health”“undo health”“undo health entry” [health_tracker.undo_health_log]

  Deletes the last thing you logged.

  can delete or close things

Images by voice 7

Render an image on your own local ComfyUI server. Added after v0.30.0-beta.2. plugins/commands/comfy.py

• “cancel the image” [comfy.cancel_the_image]

  Cancels this session's image without deleting any saved outputs.

  reads information

• “image status” [comfy.image_status]

  Reports image progress and rechecks an unresolved render.

  reads information

• “make an image of”“draw me”“generate an image of”“give me an image of”“render an image of” [comfy.make_an_image_of]

  Makes an image locally in ComfyUI, using exactly the description you say.

  reads information then say: text (optional)

• “make another” [comfy.make_another]

  Makes another image with the same description and a fresh seed.

  reads information

• “make it again but” [comfy.make_it_again_but]

  Makes another image, appending your change verbatim to the description.

  reads information then say: text (optional)

• “open the image”“open it” [comfy.open_the_image]

  Opens the last completed image in your default image viewer.

• “where is the image” [comfy.where_is_the_image]

  Says where the last completed image was saved.

  reads information

Macros 6

Short built-in routines, such as a break. plugins/commands/macros.py

• “break time”“stretch break”“take a break” [macros.break_time]

  Pauses media and locks the screen, for a break.

  changes something

• “clear my desk”“clean desktop”“hide everything” [macros.clear_my_desk]

  Minimises every window.

• “focus mode”“lets work”“time to work” [macros.focus_mode]

  Turns the volume down, opens your editor and clears distractions.

  changes something

• “going dark”“end of day”“goodnight”“shut it down” [macros.going_dark]

  Mutes the sound, minimises everything and locks the screen.

  can delete or close things

• “morning routine”“good morning”“start my day” [macros.morning_routine]

  Open daily sites, set comfortable volume.

  changes something

• “presentation mode”“demo mode” [macros.presentation_mode]

  Maximises the focused window and turns the volume up.

  changes something

Media keys 5

Play, pause and skip whatever is playing, using the media keys. plugins/commands/media_keys.py

• “next track this”“next this”“skip this” [media_keys.next_track_this]

  Skips to the next track in whatever is playing.

• “pause this”“pause active”“pause focused” [media_keys.pause_this]

  Pauses whatever is playing, using the keyboard's media keys.

• “play this”“play focused”“resume this” [media_keys.play_this]

  Resumes whatever was playing, using the keyboard's media keys.

• “previous track this”“back this”“previous this” [media_keys.previous_track_this]

  Goes back to the previous track in whatever is playing.

• “toggle this”“toggle focused” [media_keys.toggle_this]

  Plays or pauses whatever is playing, whichever it is not doing now.

Microsoft Word 24

Formatting and selection in Word. Needs Microsoft Word installed. plugins/commands/word.py

• “align center” [word.align_center]

  Centers the current Word paragraph.

• “align left” [word.align_left]

  Aligns the current Word paragraph left.

• “align right” [word.align_right]

  Aligns the current Word paragraph right.

• “bold that” [word.bold_that]

  Toggles bold for the selected Word text.

• “bullet list” [word.bullet_list]

  Toggles the selected Word paragraphs as a bulleted list.

• “double spacing” [word.double_spacing]

  Applies double line spacing in Word.

• “font bigger” [word.font_bigger]

  Increases the selected Word text's font size.

• “font size” [word.font_size]

  Sets selected Word text to a font size from 6 through 72.

  then say: remainder

• “font smaller” [word.font_smaller]

  Decreases the selected Word text's font size.

• “italic that” [word.italic_that]

  Toggles italics for the selected Word text.

• “justify text” [word.justify_text]

  Justifies the current Word paragraph.

• “line spacing” [word.line_spacing]

  Sets selected Word paragraphs to 1, 1.5, or 2 line spacing.

  then say: remainder

• “numbered list” [word.numbered_list]

  Toggles numbering on the current Word selection.

• “one and a half spacing” [word.one_and_a_half_spacing]

  Applies one-and-a-half line spacing in Word.

• “redo in word” [word.redo_in_word]

  Redoes the last Word edit without invoking Samsara dictation history.

• “select line” [word.select_line]

  Selects the current Word line.

• “select paragraph in word” [word.select_paragraph_in_word]

  Extends the Word selection through the current paragraph.

• “select sentence” [word.select_sentence]

  Selects the current Word sentence.

• “select word” [word.select_word]

  Selects the current Word word.

• “set font” [word.set_font]

  Sets selected Word text to an installed font by name.

  then say: remainder

• “single spacing” [word.single_spacing]

  Applies single line spacing in Word.

• “underline that” [word.underline_that]

  Toggles underline for the selected Word text.

• “undo in word” [word.undo_in_word]

  Undoes the last Word edit without invoking Samsara dictation history.

• “word count” [word.word_count]

  Speaks the word count of the current Word selection.

Music 11

Spotify and local music control, including importing your playlists. plugins/commands/music.py

• “import my spotify playlists”“import spotify playlists” [music.import_my_spotify_playlists]

  Open the local Spotify data export picker from voice.

• “mute”“mute spotify” [music.mute]

  Mutes or unmutes Spotify without touching the system volume.

• “next”“next song”“next track”“skip”“skip song”“skip track” [music.next]

  Skips to the next track.

• “pause”“pause music”“play pause”“stop music” [music.pause]

  Pauses whatever is playing.

• “play”“resume”“resume music”“unpause music” [music.play]

  Resumes whatever was playing.

  then say: name (optional)

• “play album”“album” [music.play_album]

  Play a named Spotify album from the user's Music library.

  then say: remainder

• “play artist”“artist” [music.play_artist]

  Play a named Spotify artist from the user's Music library.

  then say: remainder

• “play music”“place music”“place of music”“place some music”“play me”“play me some”“play me some music”“play of music”“play some”“play some music”“playing me some”“playing some”“plays music”“plays some music”“put on”“put on some” [music.play_music]

  Plays what you name on Spotify, such as play music by Nick Cave.

  then say: playlist (optional)

• “play playlist”“playlist” [music.play_playlist]

  Play a named Spotify playlist from the user's Music library.

  then say: remainder

• “previous music”“back a song”“previous”“previous song”“previous track” [music.previous_music]

  Skips back in the current media session.

• “search music”“search” [music.search_music]

  Search Spotify only after a named-library miss asked for it.

Open, focus and close apps 3

Name an app and Samsara opens it, brings it to the front or closes it. plugins/commands/app_verbs.py

• “close” [app_verbs.close]

  Closes the app you name, asking it to save first.

  changes something then say: app name (optional)

• “focus”“switch to” [app_verbs.focus]

  Brings the app you name to the front, such as focus firefox.

  then say: app name (optional)

• “open” [app_verbs.open]

  Opens the app you name, or brings it to the front if it is already running.

  then say: app name (optional)

Prompt queue 9

Hear what finished, read a report and accept it by voice. plugins/commands/queue_voice.py

• “accept prompt” [queue_voice.accept_prompt]

  Accepts a finished prompt's report by number, after you confirm. Part of the prompt-queue workflow.

  changes something then say: text (optional)

• “queue note” [queue_voice.queue_note]

  Refreshes the queue note, after you confirm.

  changes something

• “read more”“continue reading”“more”“next three”“read next” [queue_voice.read_more]

  Reads the next three results of the last list or answer.

• “read report” [queue_voice.read_report]

  Reads a finished prompt's report by number.

  then say: text (optional)

• “stop queue” [queue_voice.stop_queue]

  Stops a report being read aloud.

• “what can i run” [queue_voice.what_can_i_run]

  Lists the prompts in the queue that are ready to run.

• “what did” [queue_voice.what_did]

  Say what did, a report number, say: reads that report.

  then say: text (optional)

• “what finished”“what is done”“whats done” [queue_voice.what_finished]

  Lists the prompts that have finished.

• “whats running”“what is running” [queue_voice.whats_running]

  Lists the prompts that are running now.

Quick ask 1

Ask Claude the question that follows. plugins/commands/quick_ask.py

• “ask” [quick_ask.ask]

  Asks Claude the question that follows.

  changes something then say: text (optional)

Quick memos 2

Record and open quick memos. plugins/commands/quick_memo.py

• “open memos”“memo list”“open my memos”“show my memos” [quick_memo.open_memos]

  Opens the Memos page, where your saved memos are kept.

• “take a memo”“quick memo” [quick_memo.take_a_memo]

  Starts recording a quick memo straight away.

  changes something

Reminders 5

Set, read and cancel reminders. plugins/commands/reminders.py

• “cancel all reminders”“clear all reminders”“clear reminders”“remove all reminders” [reminders.cancel_all_reminders]

  Cancels every reminder you have set.

  can delete or close things

• “cancel reminder”“delete reminder”“remove reminder” [reminders.cancel_reminder]

  Cancels the reminder you name.

  can delete or close things then say: text (optional)

• “read reminders”“list reminders”“what reminders do i have” [reminders.read_reminders]

  Reads out the reminders you have set.

  reads information

• “remind me to”“create reminder”“set a reminder for” [reminders.remind_me_to]

  Sets a reminder from what you say, such as remind me to stretch at four.

  changes something then say: text (optional)

• “show reminders”“reminder overview”“reminder status” [reminders.show_reminders]

  Puts your reminders on the screen.

  reads information

Samsara itself 10

Updates, the live surface, and other commands about Samsara. plugins/commands/core_utils.py

• “check for updates”“check for update”“update samsara” [core_utils.check_for_updates]

  Checks GitHub for a newer version of Samsara.

  changes something

• “move preview to this screen”“move live surface to this screen” [core_utils.move_preview_to_this_screen]

  Moves the live surface's saved placement to the foreground display.

  then say: text (optional)

• “read that back”“read it back”“read my last dictation”“what did you type” [core_utils.read_that_back]

  Reads the latest committed dictation or command aloud for accessibility.

  reads information

• “reload config”“refresh config”“reload configuration”“reread config” [core_utils.reload_config]

  Re-reads your settings from disk without restarting.

• “reset floating windows”“reset indicator position”“reset live surface”“reset preview position”“reset window positions” [core_utils.reset_floating_windows]

  Alias for the one live-surface recovery action when available.

  then say: text (optional)

• “reset hints”“replay hints”“show hints again” [core_utils.reset_hints]

  Clears the hints you have already seen so they can appear again.

  changes something

• “restart samsara”“reboot samsara”“restart” [core_utils.restart_samsara]

  Closes Samsara and starts it again.

  can delete or close things

• “save alias”“remove alias” [core_utils.save_alias]

  Saves the offered wording; say "remove alias <words>" to undo it.

  changes something then say: text (optional)

• “what can i say”“help”“what are my commands”“what commands do i have” [core_utils.what_can_i_say]

  Opens the catalog-backed commands for the focused application.

  reads information

• “why didnt that work”“what did you hear”“what just happened” [core_utils.why_didnt_that_work]

  Speaks and shows the most recent recorded outcome chip.

  reads information

Screen GIF 3

Record the screen or a window as a GIF. plugins/commands/screen_gif.py

• “record my screen”“capture my screen”“record a gif”“screen record”“start recording” [screen_gif.record_my_screen]

  Starts recording the whole screen as a GIF.

  can delete or close things then say: text (optional)

• “record this window”“capture this”“record this”“record window” [screen_gif.record_this_window]

  Starts recording the focused window as a GIF.

  can delete or close things then say: text (optional)

• “stop recording”“done recording”“end recording”“finish recording”“save the gif”“stop screen recording”“stop the recording” [screen_gif.stop_recording]

  Stops the screen recording and saves the GIF.

  can delete or close things

Scrolling 16

Scroll by amount and speed. plugins/commands/scroll.py

• “bottom of page”“go to bottom”“jump to bottom” [scroll.bottom_of_page]

  Presses Ctrl+End, jumping to the bottom of the page.

• “page down”“down one page”“scroll page down” [scroll.page_down]

  Presses Page Down, moving one screenful forward.

• “page up”“scroll page up”“up one page” [scroll.page_up]

  Presses Page Up, moving one screenful back.

• “scroll down” [scroll.scroll_down]

  Scrolls down a page's worth wherever the pointer is.

• “scroll down a little” [scroll.scroll_down_a_little]

  Scrolls down a few lines wherever the pointer is.

• “scroll down fast” [scroll.scroll_down_fast]

  Scrolls down as far as one command goes, for very long pages.

• “scroll down high” [scroll.scroll_down_high]

  Scrolls a long way down, for skimming forward through a page.

• “scroll down medium” [scroll.scroll_down_medium]

  Scrolls down about twice as far as plain scroll down.

• “scroll left”“scroll left a little” [scroll.scroll_left]

  Scrolls sideways to the left, for wide tables and timelines.

• “scroll right”“scroll right a little” [scroll.scroll_right]

  Scrolls sideways to the right, for wide tables and timelines.

• “scroll up” [scroll.scroll_up]

  Scrolls up a page's worth wherever the pointer is.

• “scroll up a little” [scroll.scroll_up_a_little]

  Scrolls up a few lines wherever the pointer is.

• “scroll up fast” [scroll.scroll_up_fast]

  Scrolls up as far as one command goes, for very long pages.

• “scroll up high” [scroll.scroll_up_high]

  Scrolls a long way up, for skimming back through a page.

• “scroll up medium” [scroll.scroll_up_medium]

  Scrolls up about twice as far as plain scroll up.

• “top of page”“go to top”“jump to top” [scroll.top_of_page]

  Presses Ctrl+Home, jumping to the top of the page.

Show Numbers 13

Number every clickable thing on screen, then click one by saying its number. plugins/commands/show_numbers.py

• “click”“press”“tap” [show_numbers.click]

  Clicks the numbered thing you name, such as click seven.

  changes something then say: label (optional)

• “double click” [show_numbers.double_click]

  Double-clicks the numbered thing you name, or at the chosen point of the mouse grid.

  changes something then say: label (optional)

• “grid back”“grid up”“undo grid” [show_numbers.grid_back]

  Steps the mouse grid back one refinement, after a misheard number.

  reads information

• “hide grid”“cancel grid”“close grid”“grid off” [show_numbers.hide_grid]

  Closes the mouse grid.

  reads information

• “hide numbers”“clear labels”“dismiss numbers”“hide”“hide labels” [show_numbers.hide_numbers]

  Clears the numbered labels from the screen.

• “left click” [show_numbers.left_click]

  Clicks the numbered thing you name, or at the chosen point of the mouse grid.

  changes something then say: label (optional)

• “mouse grid”“grid”“mousegrid”“show grid” [show_numbers.mouse_grid]

  Puts a numbered grid on the screen for pointing at anything.

  reads information then say: text (optional)

• “move here”“just move”“move mouse here”“park here” [show_numbers.move_here]

  Moves the pointer to the current grid cell and closes the grid, without clicking.

  reads information

• “overlay grid”“grid test”“overlay grid test” [show_numbers.overlay_grid]

  Draws five test labels across the screen, to check the overlay paints.

• “refresh numbers”“refresh”“update numbers” [show_numbers.refresh_numbers]

  Rescans the focused window and redraws the numbered labels.

• “right click” [show_numbers.right_click]

  Right-clicks the numbered thing you name, or at the chosen point of the mouse grid.

  changes something then say: label (optional)

• “show numbers”“label things”“show”“show clickable”“show labels” [show_numbers.show_numbers]

  Numbers everything clickable in the focused window so you can name one.

  reads information

• “show overlay test”“overlay test”“show numbers debug” [show_numbers.show_overlay_test]

  Draws four test labels, to check the overlay can paint on this screen.

Smart actions 3

Capture a thought as a note, or start fresh. plugins/commands/smart_actions.py

• “brain dump” [smart_actions.brain_dump]

  Captures what you say next as a note.

  changes something then say: remainder (optional)

• “new conversation”“fresh start”“reset conversation” [smart_actions.new_conversation]

  End the current Smart Actions session.

  changes something

• “note” [smart_actions.note]

  Captures what you say next as a note.

  changes something then say: remainder (optional)

Smart lights 5

Colour and effects for Hyperion lighting. plugins/commands/hyperion_lights.py

• “light effect”“effect”“lights effect”“play effect”“run effect”“start effect” [hyperion_lights.light_effect]

  Runs the lighting effect you name, such as light effect rainbow.

  then say: text (optional)

• “lights”“change lights to”“light color”“lights to”“make the lights”“set lights”“set lights to”“set the lights to” [hyperion_lights.lights]

  Sets your lights to the colour you name, such as lights blue.

  then say: text (optional)

• “lights off”“kill the lights”“lights out”“turn lights off”“turn off the lights” [hyperion_lights.lights_off]

  Turns your lights off.

• “lights on”“turn lights on”“turn on the lights” [hyperion_lights.lights_on]

  Turns your lights back on at whatever they were showing before.

• “list effects”“show effects”“what effects are there” [hyperion_lights.list_effects]

  Reads out the lighting effects your lights can run.

  reads information

Snippets 3

Type a saved snippet and open your snippet list. plugins/commands/snippets.py

• “insert”“insert snippet”“paste snippet” [snippets.insert]

  Types a snippet you saved earlier, such as insert sign off.

  changes something then say: remainder

• “open snippets”“show my snippets”“snippet list” [snippets.open_snippets]

  Opens the Snippets page, where your saved snippets are kept.

• “save snippet”“name that snippet”“save as snippet” [snippets.save_snippet]

  Saves what you just dictated under a name, such as save snippet sign off.

  changes something then say: remainder

Start and stop helper apps 10

Start, stop and restart the helper apps Samsara knows about, and open the quick reference. plugins/commands/app_lifecycle.py

• “restart ariadne” [app_lifecycle.restart_ariadne]

  Stops Ariadne and starts it again.

  changes something then say: text (optional)

• “restart sigil server”“restart sigil” [app_lifecycle.restart_sigil_server]

  Stops the Sigil server and starts it again.

  changes something then say: text (optional)

• “restart strata” [app_lifecycle.restart_strata]

  Stops Strata and starts it again.

  changes something then say: text (optional)

• “show quick reference” [app_lifecycle.show_quick_reference]

  Opens the quick reference window.

  changes something

• “start ariadne”“launch ariadne” [app_lifecycle.start_ariadne]

  Starts Ariadne running in the background.

  changes something then say: text (optional)

• “start sigil server”“launch sigil server”“start sigil” [app_lifecycle.start_sigil_server]

  Starts the Sigil server running in the background.

  changes something then say: text (optional)

• “start strata”“launch strata” [app_lifecycle.start_strata]

  Starts Strata running in the background.

  changes something then say: text (optional)

• “stop ariadne” [app_lifecycle.stop_ariadne]

  Stops Ariadne.

  changes something then say: text (optional)

• “stop sigil server”“stop sigil” [app_lifecycle.stop_sigil_server]

  Stops the Sigil server.

  changes something then say: text (optional)

• “stop strata” [app_lifecycle.stop_strata]

  Stops Strata.

  changes something then say: text (optional)

Stremio 8

Control the Stremio player. plugins/commands/stremio.py

• “close stremio”“exit stremio”“quit stremio” [stremio.close_stremio]

  Closes the Stremio app.

  can delete or close things

• “fullscreen”“exit fullscreen”“go fullscreen”“stremio fullscreen”“toggle fullscreen” [stremio.fullscreen]

  Switches Stremio between fullscreen and a window.

• “mute stremio”“silence stremio”“unmute stremio” [stremio.mute_stremio]

  Mutes or unmutes Stremio.

• “open stremio”“bring up stremio”“launch stremio”“start stremio” [stremio.open_stremio]

  Opens the Stremio app.

• “pause stremio”“hold on”“pause it”“pause the movie”“pause the show”“pause the stream”“pause the video”“stop playing”“stop the video” [stremio.pause_stremio]

  Pauses what is playing in Stremio.

• “resume stremio”“continue playing”“keep playing”“play stremio”“resume it”“resume the movie”“resume the show”“resume the stream”“resume the video”“unpause”“unpause stremio” [stremio.resume_stremio]

  Resumes what was playing in Stremio.

• “skip back”“back up”“go backwards”“rewind”“skip backward” [stremio.skip_back]

  Jumps back in what is playing in Stremio.

• “skip forward”“fast forward”“forward”“next bit”“skip ahead” [stremio.skip_forward]

  Jumps forward in what is playing in Stremio.

Switch audio devices 2

Change the speaker or microphone by voice. plugins/commands/audio_switch.py

• “switch audio to”“use” [audio_switch.switch_audio_to]

  Switch audio output.

  then say: text (optional)

• “switch mic to”“switch microphone to”“use mic”“use microphone” [audio_switch.switch_mic_to]

  Switches the microphone to the one you name.

  then say: text (optional)

Tasks 9

Add, read and clear tasks, optionally mirrored to Todoist. plugins/commands/tasks.py

• “add to list”“add task”“add to tasks”“add to the list”“new task”“todo” [tasks.add_to_list]

  Adds what you say next to your task list.

  changes something then say: remainder (optional)

• “clear completed”“clear done tasks”“remove completed” [tasks.clear_completed]

  Deletes every task already marked as done.

  can delete or close things

• “complete task”“check task”“done task”“finish task”“task complete” [tasks.complete_task]

  Marks the task you name as done.

  changes something then say: task number (optional)

• “hide tasks”“close task list”“close tasks” [tasks.hide_tasks]

  Takes the task list off the screen.

• “read tasks”“list tasks”“read my tasks”“what are my tasks” [tasks.read_tasks]

  Reads out the tasks you have not finished.

  reads information

• “remove task”“delete task” [tasks.remove_task]

  Deletes the task you name from the list.

  can delete or close things then say: task number (optional)

• “show tasks”“open tasks”“show my tasks”“show task list”“task list” [tasks.show_tasks]

  Puts your task list on the screen.

• “sync tasks”“sync my tasks” [tasks.sync_tasks]

  Sends tasks saved on this computer to Todoist, if you turned Todoist on.

  changes something

• “whats on today”“read today”“todays tasks” [tasks.whats_on_today]

  Reads out the Todoist tasks due today, if you turned Todoist on.

  reads information

Text markers 3

Mark a place and select to it. plugins/commands/text_marker.py

• “mark here”“set marker”“start selection” [text_marker.mark_here]

  Sets the start of a selection where the pointer is.

  changes something

• “select paragraph”“grab paragraph”“select block”“select this paragraph” [text_marker.select_paragraph]

  Selects the paragraph the pointer is in.

  changes something

• “select to here”“end selection”“grab to here”“select to mark” [text_marker.select_to_here]

  Selects from the mark you set to where the pointer is now.

  changes something

Timer 1

Set a countdown. plugins/commands/timer.py

• “set a timer”“remind me in”“set timer”“start a timer”“start timer”“timer”“timer for” [timer.set_a_timer]

  Sets a countdown timer for the length you say.

  changes something then say: text (optional)

Verbatim mode 2

Dictate exactly what you say, with no formatting. plugins/commands/verbatim_toggle.py

• “literal off”“verbatim off” [verbatim_toggle.literal_off]

  Goes back to normal dictation, with capitals and punctuation added.

• “literal on”“verbatim on” [verbatim_toggle.literal_on]

  Dictates exactly what you say, with no formatting added.

Video memos 2

Record video memos with the optional camera pack. plugins/commands/video_memo.py

• “record video memo”“start video memo”“video memo” [video_memo.record_video_memo]

  Count down, then record webcam video with audio from the ACE ring.

  changes something

• “stop memo”“stop video memo” [video_memo.stop_memo]

  Finish an active video memo; otherwise leave ordinary routing intact.

  changes something

Voice dispatch 2

Send a staged prompt to an agent by number, and ask what needs you. Added after v0.30.0-beta.2. plugins/commands/dispatch_voice.py

• “send prompt” [dispatch_voice.send_prompt]

  Say send, a prompt number, to sol, luna, astra or claude code. Drafts the dispatch through the local Agora queue, reads the plan back, and starts it only after you approve.

  changes something then say: text (optional)

• “what needs me” [dispatch_voice.what_needs_me]

  Lists dispatch drafts awaiting your approval and blocked tasks.

Voice memos 2

Record a spoken memo. plugins/commands/voice_memo.py

• “cancel memo” [voice_memo.cancel_memo]

  Cancels the memo you were about to record.

  can delete or close things

• “voice memo”“capture memo” [voice_memo.voice_memo]

  Gets ready to record a memo, which you then dictate as usual.

  changes something

Volume 3

Raise, lower and mute the system volume. plugins/commands/volume.py

• “toggle mute”“silence”“unsilence” [volume.toggle_mute]

  Mutes or unmutes the system sound.

• “volume down”“decrease volume”“lower the volume”“quieter”“softer”“turn down the volume”“turn it down” [volume.volume_down]

  Turns the system volume down by twenty percent.

• “volume up”“increase volume”“louder”“raise the volume”“turn it up”“turn up the volume” [volume.volume_up]

  Turns the system volume up by twenty percent.

Web shortcuts 2

Open a site or search the web. plugins/commands/web_shortcuts.py

• “go to”“browse to”“pull up”“show me” [web_shortcuts.go_to]

  Opens the site you name, or searches Google for it.

  then say: site

• “search for”“google”“look up” [web_shortcuts.search_for]

  Searches Google for whatever you say next.

  then say: text (optional)

Window cube 24

A numbered grid of windows you can copy between and arrange. plugins/commands/window_cube.py

• “cube copy”“cube copy into” [window_cube.cube_copy]

  Copies the text from one numbered window into another.

  changes something then say: numbers (optional)

• “cube page”“cube page one”“cube page two” [window_cube.cube_page]

  Shows the next page of the numbered window grid, or the page you name.

  then say: page (optional)

• “cube tile”“cube tile and” [window_cube.cube_tile]

  Arranges the numbered windows you name side by side.

  then say: numbers (optional)

• “eight”“8” [window_cube.eight]

  Switches to window 8 in the numbered grid.

• “five”“5” [window_cube.five]

  Switches to window 5 in the numbered grid.

• “four”“4” [window_cube.four]

  Switches to window 4 in the numbered grid.

• “hide cube”“unpin cube”“unpin windows” [window_cube.hide_cube]

  Takes the numbered window grid off the screen.

• “nine”“9” [window_cube.nine]

  Switches to window 9 in the numbered grid.

• “one”“1” [window_cube.one]

  Switches to window 1 in the numbered grid.

• “refresh cube”“rescan cube”“update cube” [window_cube.refresh_cube]

  Rescans your open windows and redraws the numbered grid.

  then say: text (optional)

• “seven”“7” [window_cube.seven]

  Switches to window 7 in the numbered grid.

• “show cube”“pin cube”“pin windows” [window_cube.show_cube]

  Pins a numbered grid of your open windows to the screen.

• “six”“6” [window_cube.six]

  Switches to window 6 in the numbered grid.

• “three”“3” [window_cube.three]

  Switches to window 3 in the numbered grid.

• “two”“2” [window_cube.two]

  Switches to window 2 in the numbered grid.

• “window eight”“window 8” [window_cube.window_eight]

  Switches to window 8 in the numbered grid.

• “window five”“window 5” [window_cube.window_five]

  Switches to window 5 in the numbered grid.

• “window four”“window 4” [window_cube.window_four]

  Switches to window 4 in the numbered grid.

• “window nine”“window 9” [window_cube.window_nine]

  Switches to window 9 in the numbered grid.

• “window one”“window 1” [window_cube.window_one]

  Switches to window 1 in the numbered grid.

• “window seven”“window 7” [window_cube.window_seven]

  Switches to window 7 in the numbered grid.

• “window six”“window 6” [window_cube.window_six]

  Switches to window 6 in the numbered grid.

• “window three”“window 3” [window_cube.window_three]

  Switches to window 3 in the numbered grid.

• “window two”“window 2” [window_cube.window_two]

  Switches to window 2 in the numbered grid.

Window switcher 11

Letter your open windows and jump to one. plugins/commands/window_switcher.py

• “hide windows”“dismiss windows”“hide window labels” [window_switcher.hide_windows]

  Clears the window letters from the screen.

• “read windows”“list windows”“what windows” [window_switcher.read_windows]

  Reads out the open windows and their letters.

  reads information

• “show windows”“label windows”“window labels” [window_switcher.show_windows]

  Labels every open window with a letter so you can name one out loud.

  reads information

• “window bring”“bring forward”“bring window” [window_switcher.window_bring]

  Moves the window with the letter you name to the screen you are on.

  then say: label (optional)

• “window close” [window_switcher.window_close]

  Closes the window with the letter you name, asking it to save first.

  changes something then say: label (optional)

• “window copy”“copy from”“copy from window” [window_switcher.window_copy]

  Copies the text from one lettered window into another.

  changes something then say: labels (optional)

• “window move”“move window” [window_switcher.window_move]

  Moves the window with the letter you name to another screen.

  then say: label (optional), monitor (optional)

• “window mute”“mute window” [window_switcher.window_mute]

  Mutes the audio coming from the window with the letter you name.

  then say: label (optional)

• “window switch”“go to window”“switch to window”“window focus” [window_switcher.window_switch]

  Brings the window with the letter you name to the front.

  then say: label (optional)

• “window tile”“tile windows” [window_switcher.window_tile]

  Arranges the lettered windows you name side by side.

  then say: labels (optional)

• “window unmute”“unmute window” [window_switcher.window_unmute]

  Unmutes the audio from the window with the letter you name.

  then say: label (optional)

Windows and monitors 12

Move windows and the pointer between screens. plugins/commands/windows.py

• “bring”“bring back”“fetch”“get”“grab” [windows.bring]

  Brings the app you name to the screen your pointer is on.

  then say: app name (optional)

• “cursor to”“mouse to”“move cursor to”“move mouse to”“move the cursor to”“move the mouse to”“pointer to”“teleport cursor to”“teleport mouse to” [windows.cursor_to]

  Moves the mouse pointer to the screen or place you name.

  then say: monitor (optional)

• “delete layout”“forget layout”“remove layout” [windows.delete_layout]

  Deletes the saved window layout you name.

  can delete or close things then say: name (optional)

• “find lost windows”“lost windows”“where are my windows” [windows.find_lost_windows]

  Reports any windows sitting off-screen where you cannot reach them.

  reads information

• “find window” [windows.find_window]

  Finds the window for the app you name and brings it to the front.

  then say: app name (optional)

• “list layouts”“show layouts”“what layouts” [windows.list_layouts]

  Reads out the window layouts you have saved.

  reads information

• “movie mode”“couch mode”“movie time”“tv mode” [windows.movie_mode]

  Puts video on the TV screen and clears the other screens.

• “rescue lost windows”“bring back lost windows”“recover windows” [windows.rescue_lost_windows]

  Pulls windows that are off-screen back onto a screen you can see.

• “restore layout”“load layout”“restore window layout” [windows.restore_layout]

  Puts your windows back the way a saved layout had them.

  then say: name (optional)

• “save layout”“save this layout”“save window layout” [windows.save_layout]

  Saves where your windows are now, under the name you give it.

  changes something then say: name (optional)

• “send”“move”“put”“throw” [windows.send]

  Moves the app you name to the screen you name, such as the left one.

  then say: app name (optional), monitor

• “snap”“dock” [windows.snap]

  Snaps the focused window to the side you name, such as left or right.

  then say: side (optional)

Workflow capture 4

Record a repeated workflow and review it. Experimental. plugins/commands/workflow_capture.py

• “capture status”“how many events”“workflow capture status” [workflow_capture.capture_status]

  Says whether workflow capture is running and how much it has recorded.

• “review capture”“open capture review”“show capture review” [workflow_capture.review_capture]

  Reopens the review window showing the last workflow you captured.

• “start capture”“begin capture”“capture workflow”“start workflow capture” [workflow_capture.start_capture]

  Starts recording which shortcuts and clicks you use, never what you type.

  can delete or close things

• “stop capture”“end capture”“finish capture”“stop recording workflow” [workflow_capture.stop_capture]

  Stops recording your workflow and opens the review window.

  can delete or close things