Gergő’s Lab / Documentation
← All documentation
Reference / PREVIEW 0.2

Command reference

Ask HomeOS supported phrases, deterministic tools, arguments and developer inspector.

Updated 24 September 2026 · Versioned with the application

Ask HomeOS

Ask HomeOS is a deterministic English phrase matcher. It recognizes a small vocabulary, returns a reply and optionally emits structured tool calls. It has no language model, conversation memory or connection to real household devices.

Supported examples

Try the suggested phrases first:

  • Good night: select Night mode.
  • Kitchen lights 40 %: change the kitchen lights.
  • How warm is it?: read the simulated temperature.
  • Is anything unusual?: inspect the simulated issues.

House modes and direct device controls are also available through buttons. If a phrase is not recognized, the assistant explains the supported options; it does not improvise a device action.

Tool calls

After a command, expand Developer inspector to see the tools used. Examples:

{ "tool": "mode.set", "args": { "mode": "night" } }
{ "tool": "lights.set", "args": { "room": "kitchen", "level": 40 } }

The command layer also implements lock.set, climate.set and vacuum.start. These tools act on the local model. Their existence is not a public HTTP API or an authorization to operate real hardware.

Ctrl+K or Command+K opens navigation search. Search by a workspace view or handbook article title. Documentation’s own search includes the complete article text. Neither search sends your query to an external provider.

Extending commands

Add phrase recognition and validation in interpret in src/lib/homeos.ts, then implement the focused tool in the same model. Test the resulting state and emitted events. Keep explanatory read-only queries distinct from commands that change state.

Go somewhere

Tab to move · Enter to open · Esc to close