From 6c899cc8a3c3f3c075699d51309d756c5f0b1a0b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 9 Nov 2025 15:22:55 +0000
Subject: [PATCH 1/5] Initial plan
From 9c0bf1a32e76e5abfd7342aa0969eca079fed04c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 9 Nov 2025 15:30:12 +0000
Subject: [PATCH 2/5] Remove hass tool documentation page and all references
Co-authored-by: frenck <195327+frenck@users.noreply.github.com>
---
source/_data/glossary.yml | 3 +-
source/_docs/tools/hass.markdown | 36 -----------------------
source/_includes/asides/docs_sitemap.html | 1 -
source/_posts/2017-10-28-demo.markdown | 2 +-
source/help/trivia.markdown | 2 +-
5 files changed, 3 insertions(+), 41 deletions(-)
delete mode 100644 source/_docs/tools/hass.markdown
diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml
index 09359c15665c..b63921ee7cde 100644
--- a/source/_data/glossary.yml
+++ b/source/_data/glossary.yml
@@ -296,8 +296,7 @@
- groups
- term: HASS
definition: >-
- HASS or [hass](/docs/tools/hass/) is often used as an abbreviation for Home
- Assistant. It is also the command-line tool.
+ HASS or hass is often used as an abbreviation for Home Assistant.
- term: HassOS
definition: >-
Another name for Home Assistant Operating System
diff --git a/source/_docs/tools/hass.markdown b/source/_docs/tools/hass.markdown
deleted file mode 100644
index 26dcd7be8c3f..000000000000
--- a/source/_docs/tools/hass.markdown
+++ /dev/null
@@ -1,36 +0,0 @@
----
-title: "hass"
-description: "Description of hass."
----
-
-The command-line part of Home Assistant is `hass`.
-
-This tool is only available to users of the Home Assistant Core installation type. It is started from the command line on the computer running Home Assistant Core (accessed perhaps via SSH).
-
-```text
-$ hass -h
-usage: hass [-h] [--version] [-c path_to_config_dir] [--safe-mode]
- [--debug] [--open-ui] [--skip-pip] [-v] [--log-rotate-days LOG_ROTATE_DAYS]
- [--log-file LOG_FILE] [--log-no-color] [--script ...] [--ignore-os-check]
-
-Home Assistant: Observe, Control, Automate.
-
-optional arguments:
- -h, --help show this help message and exit
- --version show program's version number and exit
- -c path_to_config_dir, --config path_to_config_dir
- Directory that contains the Home Assistant configuration
- --safe-mode Start Home Assistant in safe mode
- --debug Start Home Assistant in debug mode
- --open-ui Open the webinterface in a browser
- --skip-pip Skips pip install of required packages on startup
- -v, --verbose Enable verbose logging to file.
- --log-rotate-days LOG_ROTATE_DAYS
- Enables daily log rotation and keeps up to the specified days
- --log-file LOG_FILE Log file to write to. If not set, CONFIG/home-assistant.log is used
- --log-no-color Disable color logs
- --script ... Run one of the embedded scripts
- --ignore-os-check Skips validation of operating system
-
-If restart is requested, exits with code 100
-```
diff --git a/source/_includes/asides/docs_sitemap.html b/source/_includes/asides/docs_sitemap.html
index 89d27716a2ce..82301222e68b 100644
--- a/source/_includes/asides/docs_sitemap.html
+++ b/source/_includes/asides/docs_sitemap.html
@@ -246,7 +246,6 @@
- {% active_link /docs/tools/dev-tools/ Developer tools %}
- {% active_link /docs/tools/quick-bar/ Quick bar %}
- - {% active_link /docs/tools/hass/ hass %}
- {% active_link /docs/tools/check_config/ check_config %}
{% endif %}
diff --git a/source/_posts/2017-10-28-demo.markdown b/source/_posts/2017-10-28-demo.markdown
index ce40642b6d60..056d8e049e33 100644
--- a/source/_posts/2017-10-28-demo.markdown
+++ b/source/_posts/2017-10-28-demo.markdown
@@ -22,7 +22,7 @@ The simplest way to show Home Assistant to others is the online demo at [/demo/]
## `--demo-mode` and Demo platform
-To be safe for your talk, you don't want to depend on an internet connection. The demo mode [`--demo-mode`](/docs/tools/hass/) allows you to run a demo locally including the latest features. Make sure that you have a backup of your configuration.
+To be safe for your talk, you don't want to depend on an internet connection. The demo mode `--demo-mode` allows you to run a demo locally including the latest features. Make sure that you have a backup of your configuration.
```bash
hass --demo-mode
diff --git a/source/help/trivia.markdown b/source/help/trivia.markdown
index 09994c9b6695..4b5b8df96a7f 100644
--- a/source/help/trivia.markdown
+++ b/source/help/trivia.markdown
@@ -8,7 +8,7 @@ This page contains only irrelevant and unhelpful information about Home Assistan
## Name
-Isn't it obvious? Home Assistant is the good soul that is assisting you in your home. It's common to refer to Home Assistant simply as HA or `hass` (not to be confused with the German word "Hass", it's more like the abbreviation of **H**ome **A**ssistant **S**erver **S**ervice). [`hass`](/docs/tools/hass/) is also the name of the command-line part.
+Isn't it obvious? Home Assistant is the good soul that is assisting you in your home. It's common to refer to Home Assistant simply as HA or `hass` (not to be confused with the German word "Hass", it's more like the abbreviation of **H**ome **A**ssistant **S**erver **S**ervice).
## Website
From 16657871027caa4425877d2db2c9ddf0c179629a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 9 Nov 2025 15:40:29 +0000
Subject: [PATCH 3/5] Update HASS glossary definition to clarify deprecated
usage
Co-authored-by: frenck <195327+frenck@users.noreply.github.com>
---
source/_data/glossary.yml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml
index b63921ee7cde..988339134d4c 100644
--- a/source/_data/glossary.yml
+++ b/source/_data/glossary.yml
@@ -296,7 +296,8 @@
- groups
- term: HASS
definition: >-
- HASS or hass is often used as an abbreviation for Home Assistant.
+ HASS is often used as an abbreviation for Home Assistant. This abbreviation
+ is no longer commonly used. Home Assistant is generally referred to as HA.
- term: HassOS
definition: >-
Another name for Home Assistant Operating System
From 478c1b0a339a5f22707ae349506bd672edf7eb57 Mon Sep 17 00:00:00 2001
From: Franck Nijhof
Date: Sun, 9 Nov 2025 18:45:38 +0100
Subject: [PATCH 4/5] Update source/_data/glossary.yml
---
source/_data/glossary.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml
index 988339134d4c..f865136a1d04 100644
--- a/source/_data/glossary.yml
+++ b/source/_data/glossary.yml
@@ -297,7 +297,7 @@
- term: HASS
definition: >-
HASS is often used as an abbreviation for Home Assistant. This abbreviation
- is no longer commonly used. Home Assistant is generally referred to as HA.
+ is no longer actively used. Home Assistant is generally referred to as HA nowadays.
- term: HassOS
definition: >-
Another name for Home Assistant Operating System
From aa0c44207a146d926bef762885e00fc50682c2e8 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 22 Nov 2025 14:10:56 +0000
Subject: [PATCH 5/5] Align abbreviation guidance with style guidelines
Co-authored-by: frenck <195327+frenck@users.noreply.github.com>
---
source/_data/glossary.yml | 5 +++--
source/help/trivia.markdown | 2 +-
2 files changed, 4 insertions(+), 3 deletions(-)
diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml
index f865136a1d04..95edca5bf14e 100644
--- a/source/_data/glossary.yml
+++ b/source/_data/glossary.yml
@@ -296,8 +296,9 @@
- groups
- term: HASS
definition: >-
- HASS is often used as an abbreviation for Home Assistant. This abbreviation
- is no longer actively used. Home Assistant is generally referred to as HA nowadays.
+ HASS is an abbreviation for Home Assistant that was commonly used in the past.
+ This abbreviation is no longer actively used. It is recommended to use the full
+ name "Home Assistant" instead of abbreviations.
- term: HassOS
definition: >-
Another name for Home Assistant Operating System
diff --git a/source/help/trivia.markdown b/source/help/trivia.markdown
index 4b5b8df96a7f..00634bba3875 100644
--- a/source/help/trivia.markdown
+++ b/source/help/trivia.markdown
@@ -8,7 +8,7 @@ This page contains only irrelevant and unhelpful information about Home Assistan
## Name
-Isn't it obvious? Home Assistant is the good soul that is assisting you in your home. It's common to refer to Home Assistant simply as HA or `hass` (not to be confused with the German word "Hass", it's more like the abbreviation of **H**ome **A**ssistant **S**erver **S**ervice).
+Isn't it obvious? Home Assistant is the good soul that is assisting you in your home. The abbreviation `hass` (not to be confused with the German word "Hass", it's more like the abbreviation of **H**ome **A**ssistant **S**erver **S**ervice) was commonly used in the past, though it's now recommended to use the full name "Home Assistant" in documentation.
## Website