coder · mafredri · Jul 21, 2023 · Jul 19, 2023 · Jul 19, 2023 · Jul 19, 2023
diff --git a/cli/dotfiles.go b/cli/dotfiles.go
@@ -193,6 +193,18 @@ func (r *RootCmd) dotfiles() *clibase.Cmd {
 				}
 
 				_, _ = fmt.Fprintf(inv.Stdout, "Running %s...\n", script)
+
+				// Check if the script is executable and notify on error
+				scriptPath := filepath.Join(dotfilesDir, script)
+				fi, err := os.Stat(scriptPath)
+				if err != nil {
+					return xerrors.Errorf("stat %s: %w", scriptPath, err)
+				}
+
+				if fi.Mode()&0o111 == 0 {
+					return xerrors.Errorf("%[1]q script is not executable. You can solve this by making it executable in your dotfiles repo:\n  chmod +x %[1]q && git add %[1]q && git commit -m \"Make %[1]s executable\" && git push", script)
+				}
+
 				// it is safe to use a variable command here because it's from
 				// a filtered list of pre-approved install scripts
 				// nolint:gosec

diff --git a/docs/dotfiles.md b/docs/dotfiles.md
@@ -60,3 +60,30 @@ sudo apt update
 # Install some of my favorite tools every time my workspace boots
 sudo apt install -y neovim fish cargo
 ```
+
+## Install or Setup script support
+
+User can have either of the following setup script files in their dotfiles repo:
+
+- install.sh
+- install
+- bootstrap.sh
+- bootstrap
+- script/bootstrap
+- setup.sh
+- setup
+- script/setup
+
+If any of these files are present, Coder will run them after cloning the dotfiles repo. If any of these files are found in the specified order, only the first match will be executed, and the rest will be skipped.
+
+The Setup scripts must be executable. If they are not, Coder will not execute them. If the script is not executable, you can make it executable by running:
+
+```bash
+cd <path_to_dotfiles_repo>
+
+chmod +x <script_name>
+
+git commit -m "Make <script_name> executable" <script_name>
+
+git push
+```