hmr/tool.toml at main · byteowlz/hmr · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# tool.toml - hmr metadata for byteowlz.com/toolz/hmr

#:schema https://raw.githubusercontent.com/byteowlz/schemas/refs/heads/main/govnr/tool.schema.json

name = "hmr"
title = "homer (hmr)"
tagline = "A slim, fast CLI for Home Assistant"

description = """
Control your Home Assistant from the terminal. Manage entities, services, events, areas, devices, templates, and more with a single binary.

Supports multiple output formats (JSON, YAML, table), fuzzy entity matching via local cache, natural language commands, shell completions, and full configuration via TOML config file with environment variable overrides.

Built for both humans and AI agents. Use the CLI for quick control, pipe JSON for automation, or integrate via natural language commands.
"""

language = "rust"
category = "toolz"
version = "0.4.1"
license = "MIT"

# ============================================================================
# Installation
# ============================================================================

[install]
homebrew = "byteowlz/tap/hmr"
aur = "hmr"
aur_bin = "hmr-bin"
cargo = "hmr"
scoop = "byteowlz/hmr"

# ============================================================================
# Links
# ============================================================================

[links]
github = "https://github.com/byteowlz/hmr"

# ============================================================================
# Features
# ============================================================================

[[features]]
title = "Entity Management"
description = "List, inspect, toggle, and control any Home Assistant entity with fuzzy matching"

[[features]]
title = "Natural Language Commands"
description = "Run commands like 'turn on kitchen light' via the do subcommand"

[[features]]
title = "Multiple Output Formats"
description = "JSON, YAML, and table output with customizable columns, sorting, and headers"

[[features]]
title = "Local Entity Cache"
description = "Fast fuzzy matching against a local cache of entities for instant tab completion"

[[features]]
title = "Service & Event Control"
description = "Call services, fire events, and render Jinja2 templates directly from the terminal"

[[features]]
title = "Area & Device Management"
description = "Browse and manage areas and devices in your Home Assistant instance"

# ============================================================================
# Examples
# ============================================================================

[[examples]]
title = "Quick Start"
language = "bash"
code = """
# Check connection
hmr info

# List entities
hmr entity list
hmr entity get light.living_room

# Control devices
hmr do "turn on kitchen light"
hmr entity toggle light.bedroom
"""

[[examples]]
title = "JSON Pipelines"
language = "bash"
code = """
# Get entities as JSON
hmr entity list --json | jq '.[].entity_id'

# Filter by area
hmr entity list --json | jq 'map(select(.area == "kitchen"))'

# Call a service
hmr service call light.turn_on --data '{"entity_id": "light.desk"}'
"""

[[examples]]
title = "Templates & Events"
language = "bash"
code = """
# Render a Jinja2 template
hmr template render "{{ states('sensor.temperature') }}"

# Fire an event
hmr event fire custom_event --data '{"key": "value"}'

# View command history
hmr history
"""

# ============================================================================
# Media
# ============================================================================

[media]
# icon = "assets/icon.svg"
logo = "logo/hmr_logo_white.svg"
screenshot = "banner.png"

# ============================================================================
# Metadata
# ============================================================================

[meta]
keywords = ["home-assistant", "cli", "iot", "automation", "smart-home", "hass"]
platforms = ["linux", "macos", "windows"]
related = ["mailz", "byt"]
status = "stable"
listed = true