diff --git a/pkgs/clan-cli/clan_cli/__init__.py b/pkgs/clan-cli/clan_cli/__init__.py
index bb67c6c9d..98e85191a 100644
--- a/pkgs/clan-cli/clan_cli/__init__.py
+++ b/pkgs/clan-cli/clan_cli/__init__.py
@@ -344,15 +344,15 @@ For more detailed information, visit: {help_hyperlink("secrets", "https://docs.c
         description="Manage machines and their configuration",
         epilog=(
             f"""
-This subcommand provides an interface to machines managed by clan.
+This subcommand provides an interface to machines managed by Clan.
 
 Examples:
 
   $ clan machines list
-  List all the machines managed by clan.
+  List all the machines managed by Clan.
 
   $ clan machines update [MACHINES]
-  Will update the specified machine [MACHINE], if [MACHINE] is omitted, the command
+  Will update the specified machines [MACHINES], if [MACHINES] is omitted, the command
   will attempt to update every configured machine.
 
   $ clan machines install [MACHINE] --target-host [TARGET_HOST]
@@ -410,9 +410,9 @@ Examples:
         description="Query state information about machines",
         epilog=(
             f"""
-This subcommand provides an interface to the state managed by clan.
+This subcommand provides an interface to the state managed by Clan.
 
-State can be folders and databases that modules depend on managed by clan.
+State can be folders and databases that modules depend on managed by Clan.
 
 State directories can be added to on a per machine basis:
 ```
@@ -427,7 +427,7 @@ can be a good choice.
 Examples:
 
   $ clan state list [MACHINE]
-  List state of the machines managed by clan.
+  List state of the machines managed by Clan.
 
 For more detailed information, visit: {help_hyperlink("getting-started", "https://docs.clan.lol/backups")}
         """
diff --git a/pkgs/clan-cli/clan_cli/machines/cli.py b/pkgs/clan-cli/clan_cli/machines/cli.py
index 7e98b21d0..10d88776e 100644
--- a/pkgs/clan-cli/clan_cli/machines/cli.py
+++ b/pkgs/clan-cli/clan_cli/machines/cli.py
@@ -24,15 +24,15 @@ def register_parser(parser: argparse.ArgumentParser) -> None:
 
     update_parser = subparser.add_parser(
         "update",
-        help="Update a machine",
+        help="Update one or more machines",
         epilog=(
             """
-This subcommand provides an interface to update machines managed by clan.
+This subcommand provides an interface to update machines managed by Clan.
 
 Examples:
 
   $ clan machines update [MACHINES]
-  Will update the specified machine [MACHINE], if [MACHINE] is omitted, the command
+  Will update the specified machines [MACHINES], if [MACHINES] is omitted, the command
   will attempt to update every configured machine.
   To exclude machines being updated `clan.deployment.requireExplicitUpdate = true;`
   can be set in the machine config.
@@ -110,7 +110,7 @@ Installing a machine means overwriting the target's disk.
         """,
         epilog=(
             """
-This subcommand provides an interface to install machines managed by clan.
+This subcommand provides an interface to install machines managed by Clan.
 
 Examples:
 
diff --git a/pkgs/clan-cli/clan_cli/machines/update.py b/pkgs/clan-cli/clan_cli/machines/update.py
index 60b1eeabb..1f84ad347 100644
--- a/pkgs/clan-cli/clan_cli/machines/update.py
+++ b/pkgs/clan-cli/clan_cli/machines/update.py
@@ -278,7 +278,7 @@ def register_update_parser(parser: argparse.ArgumentParser) -> None:
         nargs="*",
         default=[],
         metavar="MACHINE",
-        help="Machine to update. If no machine is specified, all machines will be updated.",
+        help="Machine to update. If no machines are specified, all machines that don't require explicit updates will be updated.",
     )
     add_dynamic_completer(machines_parser, complete_machines)
 
diff --git a/pkgs/clan-cli/clan_cli/state/__init__.py b/pkgs/clan-cli/clan_cli/state/__init__.py
index 8001e732e..c68569013 100644
--- a/pkgs/clan-cli/clan_cli/state/__init__.py
+++ b/pkgs/clan-cli/clan_cli/state/__init__.py
@@ -18,7 +18,7 @@ def register_parser(parser: argparse.ArgumentParser) -> None:
         description="list state folders and the services that configure them",
         epilog=(
             """
-  List state of the machines managed by clan.
+  List state of the machines managed by Clan.
 
   The backup commands are commands that will exist on the deployed machine.
   They can be introspected by checking under `/run/current-system/sw/bin/[COMMAND]`
@@ -26,7 +26,7 @@ def register_parser(parser: argparse.ArgumentParser) -> None:
   Examples:
 
   $ clan state list [MACHINE]
-  List state of the machine [MACHINE] managed by clan.
+  List state of the machine [MACHINE] managed by Clan.
 
 
   For more detailed information, visit: https://docs.clan.lol/getting-started/backups/