diff --git a/modules/hooks.nix b/modules/hooks.nix
index ef53d16d..7fc9e2f5 100644
--- a/modules/hooks.nix
+++ b/modules/hooks.nix
@@ -892,6 +892,7 @@ in
               type = types.str;
               description = lib.mdDoc "Path to a custom config file.";
               default = "";
+              example = ".typos.toml";
             };
 
           diff =
@@ -2153,6 +2154,11 @@ in
             in
             "${tools.typos}/bin/typos ${cmdArgs}${lib.optionalString settings.typos.diff " --diff"}${lib.optionalString settings.typos.hidden " --hidden"}";
           types = [ "text" ];
+          # Typos is supposed to run on the whole tree. If this is set to true,
+          # the system gets stuck for large projects due to very high memory
+          # consumption. The restriction on with files typos run, should be
+          # specified in the typos config file.
+          pass_filenames = false;
         };
       typstfmt = {
         name = "typstfmt";