feat(scripts): add x-gitprofile for mise enter hook git-profile switching

Creates .mise.toml files with enter hooks that auto-switch git
profiles when entering project directories (e.g. ~/Code/ivuorinen,
~/Code/masf).

.claude/agents/code-reviewer.md

@@ -0,0 +1,14 @@
+---
+name: code-reviewer
+description: Reviews shell/fish/lua changes for correctness and style
+tools: [Read, Grep, Glob, Bash]
+---
+
+Review the changed files for:
+
+1. **Shell scripts**: POSIX compliance for /bin/sh scripts, proper quoting, shellcheck issues
+2. **Fish files**: fish syntax correctness, consistent function patterns
+3. **Lua files**: stylua compliance, Neovim API usage patterns
+4. **All**: EditorConfig compliance (2-space indent, LF endings)
+
+Report only high-confidence issues. Skip vendor files (fzf-tmux).

.claude/hooks/async-bats.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Async Bats runner: run matching test file when a script is edited.
+# Runs in background (async: true) — output appears on next turn.
+
+fp=$(jq -r '.tool_input.file_path // empty')
+[ -z "$fp" ] && exit 0
+
+name=$(basename "$fp")
+test_file="$CLAUDE_PROJECT_DIR/tests/${name}.bats"
+[ ! -f "$test_file" ] && exit 0
+
+echo "Running $test_file ..."
+"$CLAUDE_PROJECT_DIR/node_modules/.bin/bats" "$test_file"

.claude/hooks/log-failures.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# PostToolUseFailure logger: append tool failures to a local log file.
+
+log_file="$CLAUDE_PROJECT_DIR/.claude/hook-failures.log"
+
+entry=$(jq -c '{
+  time: (now | strftime("%Y-%m-%dT%H:%M:%SZ")),
+  tool: .tool_name,
+  error: .error
+}')
+
+echo "$entry" >> "$log_file"
+
+exit 0

.claude/hooks/notify-idle.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Notification hook: alert when Claude goes idle.
+# Uses pushover if available, falls back to macOS native notification.
+
+msg=$(jq -r '.message // "Claude is waiting for input"')
+
+if command -v pushover > /dev/null; then
+  pushover "Claude Code" "$msg"
+elif command -v osascript > /dev/null; then
+  osascript -e "display notification \"$msg\" with title \"Claude Code\""
+fi
+
+exit 0

.claude/hooks/post-edit-config-warn.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Post-edit: warn when formatter/linter configs are changed,
+# since they affect the entire repo's code style.
+
+fp=$(jq -r '.tool_input.file_path // empty')
+[ -z "$fp" ] || [ ! -f "$fp" ] && exit 0
+
+case "$(basename "$fp")" in
+  .editorconfig | biome.json | .prettierrc.json | .shellcheckrc | stylua.toml | .yamllint.yml)
+    echo "NOTE: Formatter/linter config changed ($fp)." >&2
+    echo "Run 'pre-commit run --all-files' to verify consistency." >&2
+    ;;
+esac
+
+exit 0

.claude/hooks/post-edit-dotbot-validate.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Post-edit: validate Dotbot install.conf.yaml files after editing.
+# Checks YAML syntax and verifies link targets exist.
+
+fp=$(jq -r '.tool_input.file_path // empty')
+[ -z "$fp" ] || [ ! -f "$fp" ] && exit 0
+
+case "$fp" in
+  *install.conf.yaml) ;;
+  *) exit 0 ;;
+esac
+
+# YAML syntax check
+if command -v yamllint > /dev/null; then
+  if ! output=$(yamllint -d relaxed "$fp" 2>&1); then
+    echo "Dotbot config YAML error in $fp:" >&2
+    echo "$output" >&2
+    exit 2
+  fi
+elif command -v python3 > /dev/null; then
+  if ! output=$(python3 -c "import yaml; yaml.safe_load(open('$fp'))" 2>&1); then
+    echo "Dotbot config YAML parse error in $fp:" >&2
+    echo "$output" >&2
+    exit 2
+  fi
+fi
+
+exit 0

.claude/hooks/post-edit-format.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Post-edit formatter: auto-format file based on extension.
+# Receives tool output JSON on stdin.
+
+fp=$(jq -r '.tool_input.file_path // empty')
+[ -z "$fp" ] || [ ! -f "$fp" ] && exit 0
+
+case "$fp" in
+  *.sh | */bin/*)
+    head -1 "$fp" | grep -qE '^#!.*(ba)?sh' \
+      && command -v shfmt > /dev/null \
+      && shfmt -i 2 -bn -ci -sr -fn -w "$fp"
+    ;;
+  *.fish)
+    command -v fish_indent > /dev/null && fish_indent -w "$fp"
+    ;;
+  *.lua)
+    command -v stylua > /dev/null && stylua "$fp"
+    ;;
+  *.md)
+    command -v biome > /dev/null && biome format --write "$fp" 2> /dev/null
+    command -v markdown-table-formatter > /dev/null \
+      && markdown-table-formatter "$fp" 2> /dev/null
+    ;;
+  *.yml | *.yaml)
+    command -v prettier > /dev/null && prettier --write "$fp" 2> /dev/null
+    ;;
+esac
+
+exit 0

.claude/hooks/pre-edit-block.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Pre-edit guard: block vendor/lock files and secrets.d real fish files.
+# Receives tool input JSON on stdin.
+
+fp=$(jq -r '.tool_input.file_path // empty')
+[ -z "$fp" ] && exit 0
+
+case "$fp" in
+  */fzf-tmux | */yarn.lock | */.yarn/*)
+    echo "BLOCKED: $fp is a vendor/lock file — do not edit directly" >&2
+    exit 2
+    ;;
+  */tools/dotbot/* | */tools/dotbot-include/* | */tools/antidote/*)
+    echo "BLOCKED: $fp is inside a git submodule — do not edit" >&2
+    exit 2
+    ;;
+  */config/tmux/plugins/*)
+    echo "BLOCKED: $fp is a tmux plugin submodule — do not edit" >&2
+    exit 2
+    ;;
+  */config/cheat/cheatsheets/community/* | */config/cheat/cheatsheets/tldr/*)
+    echo "BLOCKED: $fp is a cheat submodule — do not edit" >&2
+    exit 2
+    ;;
+  */secrets.d/*.fish)
+    case "$(basename "$fp")" in
+      *.example.fish | *.fish.example) exit 0 ;;
+    esac
+    echo "BLOCKED: do not edit $fp directly — it is gitignored." >&2
+    echo "Copy the matching .fish.example file and edit that locally." >&2
+    exit 2
+    ;;
+esac
+
+exit 0

.claude/hooks/session-start-context.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# SessionStart context: print branch, dirty file count, and last commit.
+
+cd "$CLAUDE_PROJECT_DIR" || exit 0
+
+branch=$(git branch --show-current 2> /dev/null)
+dirty=$(git status --short 2> /dev/null | wc -l | tr -d ' ')
+last=$(git log -1 --oneline 2> /dev/null)
+
+echo "=== Dotfiles session context ==="
+echo "Branch : ${branch:-unknown}"
+echo "Dirty  : ${dirty} file(s)"
+echo "Last   : ${last}"
+
+exit 0

.claude/hooks/stop-lint-gate.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Stop gate: run yarn lint before Claude finishes.
+# Exit 2 sends feedback back and keeps Claude working.
+
+cd "$CLAUDE_PROJECT_DIR" || exit 0
+
+output=$(yarn lint 2>&1)
+status=$?
+
+if [ $status -ne 0 ]; then
+  echo "Lint failed — fix before finishing:" >&2
+  echo "$output" >&2
+  exit 2
+fi
+
+exit 0

.claude/settings.json

@@ -0,0 +1,87 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start-context.sh",
+            "statusMessage": "Loading project context..."
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-edit-block.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/post-edit-format.sh",
+            "statusMessage": "Formatting..."
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/post-edit-dotbot-validate.sh",
+            "statusMessage": "Validating Dotbot config..."
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/post-edit-config-warn.sh"
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/async-bats.sh",
+            "async": true,
+            "statusMessage": "Running tests..."
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/log-failures.sh",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "idle_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify-idle.sh",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/stop-lint-gate.sh",
+            "statusMessage": "Running lint gate..."
+          }
+        ]
+      }
+    ]
+  }
+}

.claude/skills/dotbot-validate/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: dotbot-validate
+description: >-
+  Validate Dotbot install.conf.yaml files after editing.
+  Apply when writing or modifying any install.conf.yaml.
+user-invocable: false
+allowed-tools: Bash, Read
+---
+
+After editing any `install.conf.yaml` file, validate it:
+
+## 1. YAML syntax
+
+```bash
+yamllint -d relaxed <file>
+```
+
+If yamllint is not available, fall back to:
+
+```bash
+python3 -c "import yaml; yaml.safe_load(open('<file>'))"
+```
+
+## 2. Link target verification
+
+For each `link` entry, verify the source path exists relative
+to the repo root. Report any missing source files.
+
+## 3. Host-specific configs
+
+Files in `hosts/<hostname>/install.conf.yaml` overlay the
+global config. Verify that any `include` directives reference
+existing files.
+
+## Key locations
+
+- `install.conf.yaml` — global config
+- `hosts/*/install.conf.yaml` — per-host overlays

.claude/skills/fish-validate/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: fish-validate
+description: >-
+  Validate fish scripts after editing.
+  Apply when writing or modifying any .fish file
+  in config/fish/.
+user-invocable: false
+allowed-tools: Bash, Read
+---
+
+After editing any `.fish` file in `config/fish/`, validate it:
+
+## 1. Syntax check
+
+```bash
+fish --no-execute <file>
+```
+
+If syntax check fails, fix the issue before proceeding.
+
+## 2. Format check
+
+Run `fish_indent` to verify formatting:
+
+```bash
+fish_indent --check <file>
+```
+
+If formatting differs, apply it:
+
+```bash
+fish_indent -w <file>
+```
+
+## Key files to never validate
+
+- Files inside `config/fish/functions/` prefixed with `_tide_`
+  (managed by the tide prompt plugin)

.claude/skills/host-override/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: host-override
+description: >-
+  Create or extend host-specific config overlays
+  in hosts/<hostname>/ for machine-specific settings.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit
+---
+
+When creating host-specific configuration overrides:
+
+## 1. Determine hostname
+
+```bash
+hostname -s
+```
+
+## 2. Directory structure
+
+Host overrides live in `hosts/<hostname>/` mirroring the
+global layout:
+
+```
+hosts/<hostname>/
+  base/           -> ~/.*
+  config/         -> ~/.config/
+  install.conf.yaml
+```
+
+## 3. Create install.conf.yaml
+
+If it doesn't exist, create `hosts/<hostname>/install.conf.yaml`
+following the Dotbot format. Use `include` to layer on top of
+the global config:
+
+```yaml
+- defaults:
+    link:
+      create: true
+      relink: true
+      force: true
+```
+
+## 4. Git config overrides
+
+The most common override is `hosts/<hostname>/config/git/overrides/config`.
+This is where host-specific git user, signing keys, and credential
+helpers go. Always `[include]` the shared config:
+
+```ini
+[include]
+  path = ~/.dotfiles/config/git/shared
+```
+
+## 5. Test
+
+Run `./install` to apply. Dotbot processes
+`hosts/<hostname>/install.conf.yaml` after the global config.

.claude/skills/lua-format/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: lua-format
+description: >-
+  Format Lua files after editing.
+  Apply when writing or modifying any .lua file.
+user-invocable: false
+allowed-tools: Bash
+---
+
+After editing any `.lua` file, format it with stylua:
+
+```bash
+stylua <file>
+```
+
+Project settings are in `stylua.toml` (90-char line length).
+
+If stylua is not available, skip formatting silently.
+
+## Files to never format
+
+- Files inside `config/nvim/` managed by plugins (lazy.nvim lockfile)

.claude/skills/new-fish-function/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: new-fish-function
+description: >-
+  Scaffold a new fish function in config/fish/functions/
+  with proper conventions and event handling.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit
+---
+
+When creating a new fish function in `config/fish/functions/`:
+
+## 1. Create the function file
+
+Create `config/fish/functions/<name>.fish`:
+
+```fish
+function <name> --description '<one-line description>'
+  # Function logic here
+end
+```
+
+- One function per file, filename must match function name
+- Always include `--description`
+- Use `--argument-names` for named parameters
+
+## 2. Conventions
+
+- Do NOT use `_tide_` prefix (reserved for tide prompt plugin)
+- Use `--wraps` if the function wraps an existing command
+- For abbreviation-like functions, prefer fish abbreviations
+  in `config/fish/alias.fish` instead
+
+## 3. Validate
+
+Run the fish-validate skill checks:
+
+```bash
+fish --no-execute config/fish/functions/<name>.fish
+fish_indent --check config/fish/functions/<name>.fish
+```

.claude/skills/new-script/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: new-script
+description: >-
+  Scaffold a new helper script in local/bin/ with proper
+  boilerplate, msgr sourcing, and documentation tag.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit
+---
+
+When creating a new script in `local/bin/`, follow this template:
+
+## 1. Script file
+
+Create `local/bin/<name>` with:
+
+```bash
+#!/usr/bin/env bash
+# @description <one-line description>
+
+set -euo pipefail
+
+# shellcheck source=msgr
+. "$(dirname "$0")/msgr"
+
+# Script logic here
+```
+
+- Use `msgr` functions for output: `msgr msg`, `msgr run`,
+  `msgr yay`, `msgr err`, `msgr warn`
+- The `@description` tag is required — `dfm scripts` discovers
+  scripts by it
+- POSIX scripts (`/bin/sh`) should NOT source msgr
+
+## 2. Make executable
+
+```bash
+chmod +x local/bin/<name>
+```
+
+## 3. Generate docs
+
+Run `dfm docs script <name>` or manually create `local/bin/<name>.md`
+with a usage summary.
+
+## 4. Validate
+
+Run the shell-validate skill checks (syntax + shellcheck).
+
+## Naming conventions
+
+- `x-` prefix for standalone utilities (e.g., `x-ssl-expiry-date`)
+- Short names for frequently used commands (e.g., `a`, `ad`, `ae`)
+- `git-` prefix for git subcommands (e.g., `git-dirty`)

.claude/skills/shell-validate/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: shell-validate
+description: >-
+  Validate shell scripts after editing.
+  Apply when writing or modifying any shell script
+  in local/bin/ or scripts/.
+user-invocable: false
+allowed-tools: Bash, Read, Grep
+---
+
+After editing any shell script in `local/bin/`, `scripts/`, or `config/`
+(files with a `#!` shebang or `# shellcheck shell=` directive),
+validate it:
+
+## 1. Determine the shell
+
+- `/bin/sh` or `#!/usr/bin/env sh` shebang -> POSIX, use `sh -n`
+- `/bin/bash` or `#!/usr/bin/env bash` shebang -> Bash, use `bash -n`
+- `# shellcheck shell=bash` directive (no shebang) -> use `bash -n`
+- `# shellcheck shell=sh` directive (no shebang) -> use `sh -n`
+- No shebang and no directive -> default to `bash -n`
+
+## 2. Syntax check
+
+Run the appropriate syntax checker:
+
+```bash
+bash -n <file>   # for bash scripts
+sh -n <file>     # for POSIX sh scripts
+```
+
+If syntax check fails, fix the issue before proceeding.
+
+## 3. ShellCheck
+
+Run `shellcheck <file>`. The project `.shellcheckrc` already
+disables SC2039, SC2166, SC2154, SC1091, SC2174, SC2016.
+Only report and fix warnings that are NOT in that exclude list.
+
+## Key files to never validate (not shell scripts)
+
+- `local/bin/fzf-tmux` (vendor file)
+- `*.md` files
+- `*.bats` test files (Bats, not plain shell)

.claude/skills/yaml-validate/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: yaml-validate
+description: >-
+  Validate YAML files after editing.
+  Apply when writing or modifying any .yml or .yaml file.
+user-invocable: false
+allowed-tools: Bash, Read
+---
+
+After editing any YAML file, validate it:
+
+## 1. Syntax check
+
+Run yamllint on the file:
+
+```bash
+yamllint <file>
+```
+
+If yamllint is not available, fall back to:
+
+```bash
+python3 -c "import yaml; yaml.safe_load(open('<file>'))"
+```
+
+## 2. GitHub Actions workflows
+
+If the file is under `.github/workflows/`, also run:
+
+```bash
+actionlint <file>
+```
+
+If actionlint is not available, skip silently.
+
+## Files to skip
+
+- `config/gh/hosts.yml` — managed by `gh` CLI, not hand-edited

.ecrc

@@ -1,19 +0,0 @@
-{
-  "Version": "2.7.0",
-  "Verbose": false,
-  "Debug": false,
-  "IgnoreDefaults": false,
-  "SpacesAftertabs": false,
-  "NoColor": false,
-  "Exclude": [],
-  "AllowedContentTypes": [],
-  "PassedFiles": [],
-  "Disable": {
-    "EndOfLine": false,
-    "Indentation": false,
-    "InsertFinalNewline": false,
-    "TrimTrailingWhitespace": false,
-    "IndentSize": false,
-    "MaxLineLength": false
-  }
-}

.editorconfig

@@ -8,11 +8,16 @@ indent_style = space
 insert_final_newline = true
 trim_trailing_whitespace = true
 
+[*.py]
+indent_size = 4
+max_line_length = 120
+
 [*.fish]
-max_line_length = 80
+max_line_length = 120
 
 [*.md]
-max_line_length = 100
+max_line_length = 120
+trim_trailing_whitespace = false
 
 [*.lua]
 max_line_length = 90
@@ -24,10 +29,6 @@ indent_size = 4
 indent_style = tab
 indent_size = 1
 
-[*.plist]
-indent_size = 1
-indent_style = tab
-
 [{local/bin/*,**/*.sh,**/zshrc,config/*,scripts/*}]
 indent_size        = 2
 tab_width          = 2
@@ -38,9 +39,20 @@ space_redirects    = true
 keep_padding       = false
 function_next_line = true # --func-next-line
 
+[{*.plist,config/git/**,**/config/git/**}]
+indent_size = 1
+indent_style = tab
+
 # Ignore the entire "third_party" directory when calling shfmt on directories,
 # such as "shfmt -l -w .". When formatting files directly,
 # like "shfmt -w third_party/foo.sh" or "shfmt --filename=third_party/foo.sh",
 # the ignore logic is applied only when the --apply-ignore flag is given.
 [{tools/**,local/bin/asdf/**,config/cheat/cheatsheets/**,config/tmux/plugins/**}]
 ignore = true
+
+[plan]
+trim_trailing_whitespace = false
+max_line_length = off
+
+[base/hammerspoon/hammerspoon.types.lua]
+max_line_length = off

.editorconfig-checker.json

@@ -0,0 +1,30 @@
+{
+  "Verbose": false,
+  "Debug": false,
+  "IgnoreDefaults": false,
+  "SpacesAfterTabs": false,
+  "NoColor": false,
+  "Exclude": [
+    "base/plan",
+    "config/fish/completions/.*",
+    "config/karabiner/.*",
+    "config/fish/conf.d/.*",
+    "config/fish/functions/.*",
+    "config/fzf/key-bindings.fish",
+    "config/irssi/scripts/autorun/.*",
+    "config/vim/autoload/.*",
+    "docs/.*",
+    "local/man/.*",
+    "local/share/.*"
+  ],
+  "AllowedContentTypes": [],
+  "PassedFiles": [],
+  "Disable": {
+    "EndOfLine": false,
+    "Indentation": false,
+    "InsertFinalNewline": false,
+    "TrimTrailingWhitespace": false,
+    "IndentSize": false,
+    "MaxLineLength": false
+  }
+}

.envrc

@@ -1 +0,0 @@
-use asdf

.eslintrc.json

@@ -1,3 +0,0 @@
-{
-  "extends": ["@ivuorinen"]
-}

.github/AGENTS.md

@@ -1,30 +0,0 @@
-# Guidelines for AI contributors
-
-These instructions help language models work with this repository.
-
-## Setup
-
-1. Run `yarn install` to get linting tools and the Bats test framework.
-
-## Formatting
-
-- Format code and docs with Prettier and markdownlint:
-
-```bash
-yarn fix:prettier
-yarn fix:markdown
-```
-
-- Shell scripts should pass `shellcheck`.
-
-## Testing
-
-- When code changes, run `yarn test` to execute Bats tests.
-- If only comments or documentation change, tests may be skipped.
-
-## Commits and PRs
-
-- Use Semantic Commit messages: `type(scope): summary`.
-- Keep PR titles in the same format.
-
-<!-- vim: set ft=markdown spell spelllang=en_us cc=80 : -->

.github/README.md

@@ -37,7 +37,7 @@ see what interesting stuff you've done with it. Sharing is caring.
 ### Interesting folders
 
 | Path                | Description                                  |
-| ------------------- | -------------------------------------------- |
+|---------------------|----------------------------------------------|
 | `.github`           | GitHub Repository configuration files, meta. |
 | `hosts/{hostname}/` | Configs that should apply to that host only. |
 | `local/bin`         | Helper scripts that I've collected or wrote. |
@@ -52,7 +52,7 @@ is processed by Dotbot during installation.
 ### dotfile folders
 
 | Repo      | Destination | Description                                 |
-| --------- | ----------- | ------------------------------------------- |
+|-----------|-------------|---------------------------------------------|
 | `base/`   | `.*`        | `$HOME` level files.                        |
 | `config/` | `.config/`  | Configurations for applications.            |
 | `local/`  | `.local/`   | XDG Base folder: `bin`, `share` and `state` |
@@ -86,7 +86,7 @@ The folder structure follows [XDG Base Directory Specification][xdg] where possi
 ### XDG Variables
 
 | Env                | Default              | Short description                              |
-| ------------------ | -------------------- | ---------------------------------------------- |
+|--------------------|----------------------|------------------------------------------------|
 | `$XDG_BIN_HOME`    | `$HOME/.local/bin`   | Local binaries                                 |
 | `$XDG_CONFIG_HOME` | `$HOME/.config`      | User-specific configs                          |
 | `$XDG_DATA_HOME`   | `$HOME/.local/share` | User-specific data files                       |

.github/dependabot.yml

@@ -1,7 +0,0 @@
-version: 2
-updates:
-  # Maintain dependencies for GitHub Actions
-  - package-ecosystem: 'github-actions'
-    directory: '/'
-    schedule:
-      interval: 'weekly'

.github/tag-changelog-config.js

@@ -16,10 +16,10 @@ module.exports = {
 
   excludeTypes: [],
 
-  renderTypeSection: function (label, commits) {
+  renderTypeSection: (label, commits) => {
     let text = `\n## ${label}\n\n`
 
-    commits.forEach(commit => {
+    commits.forEach((commit) => {
       const scope = commit.scope ? `**${commit.scope}:** ` : ''
       text += `- ${scope}${commit.subject}\n`
     })
@@ -27,10 +27,10 @@ module.exports = {
     return text
   },
 
-  renderChangelog: function (release, changes) {
+  renderChangelog: (release, changes) => {
     const now = new Date()
     const d = now.toISOString().substring(0, 10)
     const header = `# ${release} - ${d}\n`
-    return header + changes + '\n\n'
+    return `${header}${changes}\n\n`
   },
 }

.github/workflows/changelog.yml

@@ -9,25 +9,27 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  contents: read
 
 jobs:
   debug-changelog:
-    runs-on: self-hosted
+    runs-on: ubuntu-latest
 
-    permissions: write-all
+    permissions:
+      contents: read
 
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Create changelog text
         id: changelog
-        uses: loopwerk/tag-changelog@941366edb8920e2071eae0449031830984b9f26e # v1.3.0
+        uses: loopwerk/tag-changelog@8dd150d55fbf1fe93e0ea00a29a6153aaeb81912 # v1.5.0
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           config_file: .github/tag-changelog-config.js
 
-      - name: 'Echo results'
+      - name: "Echo results"
         id: output-changelog
         run: |
           echo "${{ steps.changelog.outputs.changes }}"

.github/workflows/linters.yml

@@ -2,15 +2,17 @@
 # yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
 name: Lint Code Base
 
+# yamllint disable-line
 on:
   pull_request:
-    branches: [master, main]
+    branches: [main]
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  contents: read
 
 jobs:
   Linter:
@@ -18,19 +20,20 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 15
     permissions:
-      statuses: write
       contents: read
+      issues: write
       packages: read
+      pull-requests: write
+      statuses: write
 
     steps:
       - name: Checkout
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Yarn Lock Changes
-        uses: Simek/yarn-lock-changes@34017425198654c20162a4dfd4f238fbece9636f # v0.12.1
+        uses: Simek/yarn-lock-changes@59f47ee499424d2c2437c5aebf863b5c6d50a5bc # v0.14.1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Run PR Lint
-        # https://github.com/ivuorinen/actions
-        uses: ivuorinen/actions/pr-lint@c0f919957eb60743682a6e0cd6d454fd4b142ac9 # 25.6.30
+        uses: ivuorinen/actions/pr-lint@1da3a0e79fcd7da6bed9ee1979f1449ba11f58f9 # v2026.03.14

.github/workflows/new-release.yml

@@ -5,26 +5,28 @@ name: Release Daily State
 on:
   workflow_dispatch:
   schedule:
-    - cron: '0 21 * * *' # 00:00 at Europe/Helsinki
+    - cron: "0 21 * * *" # 00:00 at Europe/Helsinki
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  contents: read
 
 jobs:
   new-daily-release:
-    runs-on: self-hosted
+    runs-on: ubuntu-latest
 
-    permissions: write-all
+    permissions:
+      contents: write
 
     outputs:
       created: ${{ steps.daily-version.outputs.created }}
       version: ${{ steps.daily-version.outputs.version }}
 
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Create tag if necessary
         uses: fregante/daily-version-action@fb1a60b7c4daf1410cd755e360ebec3901e58588 # v2.1.3
@@ -33,14 +35,14 @@ jobs:
       - name: Create changelog text
         if: steps.daily-version.outputs.created
         id: changelog
-        uses: loopwerk/tag-changelog@941366edb8920e2071eae0449031830984b9f26e # v1.3.0
+        uses: loopwerk/tag-changelog@8dd150d55fbf1fe93e0ea00a29a6153aaeb81912 # v1.5.0
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           config_file: .github/tag-changelog-config.js
 
       - name: Create release
         if: steps.daily-version.outputs.created
-        uses: softprops/action-gh-release@72f2c25fcb47643c292f7107632f7a47c1df5cd8 # v2.3.2
+        uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2.6.1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           tag_name: ${{ steps.daily-version.outputs.version }}

.github/workflows/pre-commit-autoupdate.yml

@@ -5,34 +5,35 @@ name: Pre-commit autoupdate
 on:
   schedule:
     # At 04:00 on Monday and Thursday.
-    - cron: '0 4 * * 1,4'
+    - cron: "0 4 * * 1,4"
   workflow_dispatch:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  contents: read
 
 jobs:
   auto-update:
-    runs-on: self-hosted
+    runs-on: ubuntu-latest
 
     permissions:
       contents: write
       pull-requests: write
 
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
-      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
 
       - run: pip install pre-commit && pre-commit autoupdate
 
-      - uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8
+      - uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           branch: update/pre-commit-hooks
-          title: 'chore: update pre-commit hooks'
-          commit-message: 'chore: update pre-commit hooks'
+          title: "chore: update pre-commit hooks"
+          commit-message: "chore: update pre-commit hooks"
           body: Update versions of pre-commit hooks to latest version.

.github/workflows/semantic-pr.yml

@@ -2,8 +2,9 @@
 # $schema: "https://json.schemastore.org/github-workflow.json"
 name: Semantic PR
 
+# yamllint disable-line
 on:
-  pull_request_target:
+  pull_request:
     types:
       - opened
       - edited
@@ -13,14 +14,15 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  pull-requests: read
 
 jobs:
   semantic-pr:
-    runs-on: self-hosted
+    runs-on: ubuntu-latest
 
     steps:
-      - uses: amannn/action-semantic-pull-request@0723387faaf9b38adef4775cd42cfd5155ed6017 # v5.5.3
+      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:

.github/workflows/sync-labels.yml

@@ -11,7 +11,7 @@ on:
       - .github/workflows/sync-labels.yml
       - .github/labels.yml
   schedule:
-    - cron: '34 5 * * *'
+    - cron: "34 5 * * *"
   workflow_call:
   workflow_dispatch:
 
@@ -19,14 +19,15 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  contents: read
 
 jobs:
   SyncLabels:
-    runs-on: self-hosted
+    runs-on: ubuntu-latest
 
     permissions:
       issues: write
 
     steps:
-      - uses: ivuorinen/actions/sync-labels@c0f919957eb60743682a6e0cd6d454fd4b142ac9 # 25.6.30
+      - uses: ivuorinen/actions/sync-labels@1da3a0e79fcd7da6bed9ee1979f1449ba11f58f9 # v2026.03.14

.github/workflows/update-submodules.yml

@@ -5,44 +5,48 @@ name: Update submodules
 on:
   schedule:
     # At 04:00 on Monday and Thursday.
-    - cron: '0 4 * * 1'
+    - cron: "0 4 * * 1,4"
   workflow_dispatch:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions: read-all
+permissions:
+  contents: read
 
 jobs:
   update-submodules:
-    runs-on: self-hosted
+    runs-on: ubuntu-latest
 
-    permissions: write-all
+    permissions:
+      contents: write
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           submodules: true
           fetch-depth: 2
           token: ${{secrets.GITHUB_TOKEN}}
 
       - name: Config Git User
+        shell: bash
         run: |
           git config --global user.name "${{ github.actor }}"
           git config --global user.email "${{ github.actor }}@users.noreply.github.com"
 
       - name: Update submodules
+        shell: bash
         run: |
           git submodule sync
-          git submodule foreach --quiet '
-            tag="$(git describe --tags --abbrev=0 origin/HEAD)"
-            if [ "$(git describe --tags)" != "$tag" ]; then
-              git checkout --quiet "$tag"
-              echo "$name updated to $tag"
+          git submodule foreach --quiet "
+            tag=\"$(git describe --tags --abbrev=0 origin/HEAD)\"
+            if [ \"$(git describe --tags)\" != \"$tag\" ]; then
+              git checkout --quiet \"$tag\"
+              echo \"$name updated to $tag\"
             fi
-          '
+          "
 
           if git diff --quiet; then
             echo "No updates for submodules."

.gitignore

@@ -9,43 +9,64 @@
 .env
 .idea
 .nfs*
+.scannerwork
 .vscode
+.yarn/
+!config/git/local.d/.gitkeep
+!config/nvim/spell/.gitkeep
+!config/zed/settings.json
+!ssh/local.d/.gitkeep
+**/exports-secret.fish
+**/exports.secret.fish
+*.tmp.*
 Brewfile.lock.json
 antidote_plugins.zsh
 config/alacritty/theme-active.toml
 config/cheat/cheatsheets/pure-bash-bible/*
 config/cheat/cheatsheets/tldr/*
+config/fish/completions/asdf.fish
+config/fish/completions/kubectl.fish
+config/fish/completions/orbctl.fish
+config/fish/fish_variables
+config/fish/fish_variables.*
+config/fish/secrets.d/*
+!config/fish/secrets.d/*.example
+!config/fish/secrets.d/README.md
+config/gh/hosts.yml
 config/git/credentials
+config/git/local.d/*
 config/gnupg/S.*
 config/gnupg/private-keys-v1.d
 config/gnupg/s
 config/iterm2/AppSupport
+config/karabiner/automatic_backups
 config/npm/npmrc
 config/nvim/lazy-lock.json
 config/nvim/spell/*
-!config/nvim/spell/.gitkeep
-config/git/local.d/*
-!config/git/local.d/.gitkeep
+config/op/plugins/gh.json
+config/op/plugins/used_items/gh.json
+config/vim/.netrwhist
+config/vim/extra/*
 config/vim/fzf
 config/vim/plugged/*
 config/zed/*
-!config/zed/settings.json
+config/zed/settings.json
 config/zsh/.zcompdump
+dependency-check-report.html
 iTermServer-*
 lazy-lock.json
-local/share/fonts/*
 local/bin/asdf/plugins/*
-lock
-node_modules
-ssh/local.d/*
-!ssh/local.d/.gitkeep
-config/fish/fish_variables
-**/exports.secret.fish
-**/exports-secret.fish
-config/fish/completions/asdf.fish
-config/vim/.netrwhist
-config/vim/extra/*
-config/gh/hosts.yml
-dependency-check-report.html
 local/bin/yabai
 local/man/yabai.1
+local/share/fonts/*
+lock
+node_modules
+__pycache__
+ssh/local.d/*
+config/fish/fish_variables*
+
+# Allow .claude directory (overrides global **/.claude/* ignore)
+!.claude/
+!.claude/**
+.claude/**/*.log
+.claude/settings.local.json

.gitmodules

@@ -4,11 +4,6 @@
 	url = https://github.com/anishathalye/dotbot.git
 	ignore = dirty
 
-[submodule "dotbot-brew"]
-	path = tools/dotbot-brew
-	url = https://github.com/wren/dotbot-brew.git
-	ignore = dirty
-
 [submodule "dotbot-include"]
 	path = tools/dotbot-include
 	url = https://gitlab.com/gnfzdz/dotbot-include.git
@@ -24,41 +19,16 @@
 	url = https://github.com/tmux-plugins/tmux-continuum
 	ignore = dirty
 
-[submodule "tmux/tmux-sensible"]
-	path = config/tmux/plugins/tmux-sensible
-	url = https://github.com/tmux-plugins/tmux-sensible.git
-	ignore = dirty
-
 [submodule "tmux/tmux-sessionist"]
 	path = config/tmux/plugins/tmux-sessionist
 	url = https://github.com/tmux-plugins/tmux-sessionist.git
 	ignore = dirty
 
-[submodule "tmux/tmux-yank"]
-	path = config/tmux/plugins/tmux-yank
-	url = https://github.com/tmux-plugins/tmux-yank.git
-	ignore = dirty
-
-[submodule "tmux/tmux-window-name"]
-	path = config/tmux/plugins/tmux-window-name
-	url = https://github.com/ivuorinen/tmux-window-name.git
-	ignore = dirty
-
-[submodule "dotbot-pip"]
-	path = tools/dotbot-pip
-	url = https://github.com/sobolevn/dotbot-pip.git
-	ignore = dirty
-
 [submodule "tmux/tmux-suspend"]
 	path = config/tmux/plugins/tmux-suspend
 	url = https://github.com/MunifTanjim/tmux-suspend.git
 	ignore = dirty
 
-[submodule "tmux/tmux-mode-indicator"]
-	path = config/tmux/plugins/tmux-mode-indicator
-	url = https://github.com/MunifTanjim/tmux-mode-indicator.git
-	ignore = dirty
-
 [submodule "tmux/tmux-current-pane-hostname"]
 	path = config/tmux/plugins/tmux-current-pane-hostname
 	url = https://github.com/soyuka/tmux-current-pane-hostname.git
@@ -71,7 +41,7 @@
 
 [submodule "tmux/tmux-dark-notify"]
 	path = config/tmux/plugins/tmux-dark-notify
-	url = https://github.com/erikw/tmux-dark-notify.git
+	url = https://github.com/ivuorinen/tmux-dark-notify.git
 	ignore = dirty
 
 [submodule "antidote"]
@@ -83,3 +53,8 @@
 [submodule "tmux/tmux-resurrect"]
 	path = config/tmux/plugins/tmux-resurrect
 	url = https://github.com/tmux-plugins/tmux-resurrect.git
+	ignore = dirty
+[submodule "tmux/catppuccin"]
+	path = config/tmux/plugins/catppuccin
+	url = https://github.com/catppuccin/tmux.git
+	ignore = dirty

.ignore

@@ -1,10 +1,10 @@
 **/__pycache__/**
+*.pyc
 .git/**
 config/cheat/cheatsheets/community/**
 config/tmux/plugins/**
+config/vim/plugged/**
 node_modules
 tools/antidote/**
-tools/dotbot-brew/**
 tools/dotbot-include/**
 tools/dotbot/**
-*.pyc

.markdownlint.json

@@ -1,19 +0,0 @@
-{
-  "extends": "@ivuorinen/markdownlint-config",
-  "code-block-style": {
-    "style": "fenced"
-  },
-  "code-fence-style": {
-    "style": "backtick"
-  },
-  "heading-style": {
-    "style": "atx"
-  },
-  "no-duplicate-heading": {
-    "siblings_only": true
-  },
-  "required-headings": false,
-  "ul-style": {
-    "style": "dash"
-  }
-}

.markdownlintignore

@@ -1,9 +1,10 @@
 # only care about files that are directly under our control
+.git/*
 config/cheat/cheatsheets/community/*
 config/cheat/cheatsheets/tldr/*
 config/op/plugins/used_plugins/*
 config/tmux/plugins/*
+config/vim/*
 local/bin/asdf/*
-tools/*
 node_modules/*
-
+tools/*

.mega-linter.yml

@@ -2,7 +2,6 @@
 # Configuration file for MegaLinter
 # See all available variables at
 # https://megalinter.io/configuration/ and in linters documentation
-
 APPLY_FIXES: all
 SHOW_ELAPSED_TIME: false # Show elapsed time at the end of MegaLinter run
 PARALLEL: true
@@ -10,20 +9,21 @@ VALIDATE_ALL_CODEBASE: true
 FILEIO_REPORTER: false # Generate file.io report
 GITHUB_STATUS_REPORTER: true # Generate GitHub status report
 IGNORE_GENERATED_FILES: true # Ignore generated files
-JAVASCRIPT_DEFAULT_STYLE: prettier # Default style for JavaScript
 PRINT_ALPACA: false # Print Alpaca logo in console
 SARIF_REPORTER: true # Generate SARIF report
 SHOW_SKIPPED_LINTERS: false # Show skipped linters in MegaLinter log
-TYPESCRIPT_DEFAULT_STYLE: prettier # Default style for TypeScript
-
 DISABLE_LINTERS:
   - REPOSITORY_DEVSKIM
-
+  - JAVASCRIPT_ES # using biome
+  - JAVASCRIPT_PRETTIER # using biome
+  - TYPESCRIPT_PRETTIER # using biome
+  - JSON_PRETTIER # using biome
+  - PYTHON_BLACK # using ruff
+  - PYTHON_FLAKE8 # using ruff
+  - PYTHON_PYLINT # using ruff
+  - PYTHON_ISORT # using ruff (I rules)
 YAML_YAMLLINT_CONFIG_FILE: .yamllint.yml
-MARKDOWN_MARKDOWNLINT_CONFIG_FILE: .markdownlint.json
-JAVASCRIPT_ES_CONFIG_FILE: .eslintrc.json
-TYPESCRIPT_ES_CONFIG_FILE: .eslintrc.json
-
+REPOSITORY_GIT_DIFF_DISABLE_ERRORS: true
+BASH_SHFMT_ARGUMENTS: -i 2 -bn -ci -sr -fn
 FILTER_REGEX_EXCLUDE: >
   (node_modules|tools|config/cheat/cheatsheets/community|config/cheat/cheatsheets/tldr|config/fzf|config/zsh|config/tmux/plugins)
-

.mise.toml

@@ -0,0 +1,4 @@
+[tools]
+node = "24.14.0"
+python = "3.14.3"
+go = "1.26.1"

.nvmrc

@@ -1 +0,0 @@
-22.17.0

.pre-commit-config.yaml

@@ -1,6 +1,7 @@
+---
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: requirements-txt-fixer
       - id: detect-aws-credentials
@@ -19,47 +20,64 @@ repos:
       - id: end-of-file-fixer
       - id: mixed-line-ending
         args: [--fix=auto]
-      - id: pretty-format-json
-        args: [--autofix, --no-sort-keys]
 
-  - repo: https://github.com/igorshubovych/markdownlint-cli
-    rev: v0.45.0
+  - repo: local
     hooks:
-      - id: markdownlint
-        args: [-c, .markdownlint.json, --fix]
+      - id: biome-check
+        name: Biome Check
+        entry: yarn biome check --write --files-ignore-unknown=true --no-errors-on-unmatched
+        language: system
+        files: \.(js|ts|jsx|tsx|json)$
+      - id: markdown-table-formatter
+        name: Markdown Table Formatter
+        entry: yarn markdown-table-formatter
+        language: system
+        types: [markdown]
 
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.37.1
+    rev: v1.38.0
     hooks:
       - id: yamllint
 
-  - repo: https://github.com/koalaman/shellcheck-precommit
-    rev: v0.10.0
+  - repo: local
+    hooks:
+      - id: prettier
+        name: Prettier (YAML)
+        entry: yarn prettier --write
+        language: system
+        types_or: [yaml]
+
+  - repo: https://github.com/shellcheck-py/shellcheck-py
+    rev: v0.11.0.1
     hooks:
       - id: shellcheck
 
   - repo: https://github.com/scop/pre-commit-shfmt
-    rev: v3.11.0-1
+    rev: v3.12.0-2
     hooks:
       - id: shfmt
+        args: [-i, "2", -bn, -ci, -sr, -fn, -w]
 
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.7
+    rev: v1.7.11
     hooks:
       - id: actionlint
 
-  - repo: https://github.com/renovatebot/pre-commit-hooks
-    rev: 41.23.2
-    hooks:
-      - id: renovate-config-validator
-
   - repo: https://github.com/JohnnyMorganz/StyLua
-    rev: v2.1.0
+    rev: v2.4.0
     hooks:
       - id: stylua # or stylua-system / stylua-github
+        exclude: hammerspoon\.types\.lua$
 
   - repo: https://github.com/hugoh/pre-commit-fish.git
     rev: v1.2
     hooks:
       - id: fish_syntax
       - id: fish_indent
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.6
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format

.prettierignore

@@ -1,15 +1,18 @@
-# vim: ft=gitignore
-.mypy_cache/*
+node_modules
+.yarn
+.pnp.*
+.mypy_cache
 Brewfile.lock.json
+lazy-lock.json
 config/cheat/cheatsheets/community
 config/cheat/cheatsheets/tldr
-config/fzf/*
-config/nvim/*
-config/op/plugins/used_plugins/*
-config/tmux/plugins/*
-config/zsh/*
-lazy-lock.json
+config/fzf
+config/nvim
+config/op/plugins/used_plugins
+config/tmux/plugins
+config/vim/plugged
+config/zsh
 local/bin/antigen.zsh
 local/bin/asdf
-tools/antidote/*
-tools/dotbot*
+tools
+config/gh/hosts.yml

.prettierrc.js

@@ -1,14 +0,0 @@
-module.exports = {
-  ...require('@ivuorinen/prettier-config'),
-  trailingComma: 'all',
-  // Add custom options below:
-  overrides: [
-    {
-      files: '*.md',
-      options: {
-        printWidth: 120,
-        proseWrap: 'preserve',
-      },
-    },
-  ],
-}

.prettierrc.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "printWidth": 200,
+  "tabWidth": 2,
+  "useTabs": false,
+  "endOfLine": "lf",
+  "singleQuote": false,
+  "proseWrap": "preserve"
+}

.python-version

@@ -1 +0,0 @@
-3.13.5

.serena/.gitignore

@@ -0,0 +1 @@
+/cache

.serena/memories/areas_for_improvement.md

@@ -0,0 +1,67 @@
+# Areas for Improvement
+
+## Code Quality Enhancements
+
+### 1. Configuration Management
+
+- **Inconsistent indentation**: Mixed tabs/spaces across config files
+- **Line length management**: Need consistent enforcement of limits
+- **Template standardization**: Memory files need consistent formatting template
+
+### 2. Linting Configuration Improvements
+
+- **Shellcheck exclusions**: Add proper ignore patterns for submodules
+- **EditorConfig refinement**: Some rules too strict for generated/third-party content
+- **Prettier ignore patterns**: Better exclusion of binary/generated files
+
+### 3. Testing Infrastructure
+
+- **Bats test errors**: Tests failing due to missing `rm` command in PATH
+- **Test coverage**: Limited test coverage for shell functions
+- **CI/CD integration**: Need automated linting in GitHub Actions
+
+### 4. Documentation Gaps
+
+- **Onboarding docs**: Missing clear setup instructions for new contributors
+- **Troubleshooting guide**: Need common error resolution steps
+- **Architecture overview**: Missing high-level system architecture
+
+## Performance & Maintenance
+
+### 5. Submodule Management
+
+- **Large submodules**: Some submodules contain unnecessary files
+- **Update frequency**: Need systematic submodule update process
+- **Dependency tracking**: Better documentation of submodule purposes
+
+### 6. Cross-Platform Considerations
+
+- **Darwin-specific paths**: Some hardcoded macOS paths could be parameterized
+- **Shell compatibility**: More testing across bash/zsh/fish environments
+- **Tool availability**: Better fallbacks when optional tools missing
+
+### 7. Security & Privacy
+
+- **Secret management**: Better examples for secret configuration
+- **Permission handling**: Some scripts could use more restrictive permissions
+- **Audit trail**: Track configuration changes and their impact
+
+## Development Workflow
+
+### 8. Automation Opportunities
+
+- **Auto-formatting**: Pre-commit hooks for consistent formatting
+- **Dependency updates**: Automated updates for package.json dependencies
+- **Health checks**: Scripts to validate configuration integrity
+
+### 9. Error Handling
+
+- **Graceful degradation**: Better fallbacks when tools unavailable
+- **Error messages**: More informative error output
+- **Recovery procedures**: Automated recovery from common failures
+
+### 10. Modularity
+
+- **Configuration splitting**: Some large config files could be modularized
+- **Feature flags**: Optional components for minimal installations
+- **Host-specific configs**: Better organization of machine-specific settings

.serena/memories/code_style_conventions.md

@@ -0,0 +1,50 @@
+# Code Style and Conventions
+
+## EditorConfig Rules (.editorconfig)
+
+- **Charset**: UTF-8
+- **Line endings**: LF
+- **Indent style**: Spaces (except for specific files)
+- **Indent size**: 2 spaces (default)
+- **Final newline**: Required
+- **Trailing whitespace**: Trimmed
+
+### Language-specific Rules
+
+- **Fish scripts**: 4-space indent, 80 char line limit
+- **PHP files**: 4-space indent
+- **Markdown**: 120 char line limit
+- **Lua**: 90 char line limit
+- **Git files**: Tab indentation
+- **Shell scripts**: 2-space indent with specific shfmt settings
+
+## Prettier Configuration
+
+- Extends `@ivuorinen/prettier-config`
+- **Trailing commas**: Always
+- **Markdown**: 120 char width, preserve prose wrapping
+
+## ESLint Configuration
+
+- Extends `@ivuorinen` base configuration
+- Applied to JavaScript/TypeScript files
+
+## Shell Script Standards (.shellcheckrc)
+
+- External sources following enabled
+- Disabled checks: SC2039, SC2166, SC2154, SC1091, SC2174, SC2016
+- Must include shebang or `# shellcheck shell=bash`
+
+## Formatting Tools
+
+- **Shell scripts**: shfmt with specific rules
+- **Markdown**: markdownlint + prettier
+- **JavaScript/TypeScript**: prettier + eslint
+- **YAML**: yamllint
+
+## Naming Conventions
+
+- **Shell functions**: Use `x-` prefix for cross-shell compatibility
+- **Environment variables**: UPPERCASE with underscores
+- **File names**: lowercase with hyphens for scripts
+- **Directory structure**: lowercase, organized by tool/purpose

.serena/memories/critical_linting_errors.md

@@ -0,0 +1,80 @@
+# Critical Linting Errors That Must Be Fixed
+
+## Current Status: BLOCKING Issues Identified
+
+The linting system has revealed 150+ violations across multiple categories that must be addressed immediately.
+
+## EditorConfig Violations (High Priority)
+
+### Missing Final Newlines
+
+- All `.serena/memories/*.md` files missing final newlines
+- Multiple project configuration files affected
+- This is a BLOCKING issue per user instructions
+
+### Line Length Violations
+
+- Fish shell configs exceed 80-character limit (`.editorconfig` enforced)
+- Memory files have lines exceeding 120-character limit
+- WezTerm configuration files have long lines
+
+### Indentation Errors
+
+- Git configuration using tabs instead of spaces
+- WezTerm color scheme files using tabs vs spaces
+- Perl scripts with inconsistent indentation
+
+## Markdownlint Issues (Memory Files)
+
+### Systematic Problems Across All Memory Files
+
+- Missing blank lines around headings (MD022)
+- Lists not surrounded by blank lines (MD032)
+- Fenced code blocks not surrounded by blank lines (MD031)
+- Trailing punctuation in headings (MD026)
+- Missing language specification for fenced code blocks (MD040)
+- Missing final newlines (MD047)
+
+### Specific Files Affected
+
+- `areas_for_improvement.md`: 20+ violations
+- `code_style_conventions.md`: 15+ violations
+- `critical_linting_errors.md`: 25+ violations
+- `darwin_system_utilities.md`: 15+ violations
+- `immediate_action_items.md`: 25+ violations
+- `project_overview.md`: 15+ violations
+- `project_structure.md`: 20+ violations
+- `shellcheck_issues.md`: 15+ violations
+- `suggested_commands.md`: 25+ violations
+- `task_completion_checklist.md`: 10+ violations
+
+## Prettier Formatting Issues
+
+### JSON Configuration Files
+
+- `.commitlintrc.json`, `.eslintrc.json`, `.luarc.json`
+- `.releaserc.json`, `.github/renovate.json`
+- Host-specific configurations in `config/` directory
+
+### YAML Files
+
+- `.mega-linter.yml` formatting inconsistencies
+- Various configuration files needing formatting
+
+## Immediate Action Required
+
+1. **Fix memory files**: Apply markdown formatting rules
+2. **Run auto-fixers**: `yarn fix` to address automatic fixes
+3. **Manual corrections**: Address remaining EditorConfig violations
+4. **Validation**: Ensure `yarn lint` passes completely
+
+## Impact Assessment
+
+These violations prevent:
+
+- Successful CI/CD pipeline execution
+- Code quality standards compliance
+- Pre-commit hook success
+- Project maintainability standards
+
+Per user instructions: "Linting issues ARE NOT ACCEPTABLE" and "EditorConfig problems are blocking errors"

.serena/memories/darwin_system_utilities.md

@@ -0,0 +1,66 @@
+# Darwin (macOS) System Utilities
+
+## Available Command Paths
+
+Based on the current system setup:
+
+### Core System Commands
+
+- `git`: `/opt/homebrew/bin/git` (Homebrew version)
+- `find`: `/usr/bin/find` (system version)
+- `cd`: shell built-in command
+- `ls`: aliased to `eza -h -s=type --git --icons --group-directories-first`
+- `grep`: aliased to `grep --color`
+
+### Modern Alternatives (Rust-based)
+
+- `fd`: `/Users/ivuorinen/.local/share/cargo/bin/fd` (modern find)
+- `rg`: `/Users/ivuorinen/.local/share/cargo/bin/rg` (ripgrep for text search)
+
+## Recommended Usage Patterns
+
+### File Search
+
+```bash
+# Use fd instead of find when possible
+fd "*.sh"                    # Find shell scripts
+fd -t f -e lua              # Find Lua files
+find . -name "*.sh"         # Fallback to system find
+```
+
+### Text Search
+
+```bash
+# Use rg (ripgrep) instead of grep when possible
+rg "function.*bash"         # Search for bash functions
+rg -t shell "export"        # Search in shell files only
+grep "pattern" file.txt     # Fallback to system grep
+```
+
+### Directory Navigation
+
+```bash
+# Use eza features via ls alias
+ls                          # Shows icons, git status, grouped directories
+ls -la                      # Long format with hidden files
+cd /full/path               # Always use full paths in scripts
+```
+
+## Path Configuration
+
+The system is configured with these PATH priorities:
+
+1. `~/.local/bin` (user scripts)
+2. `~/.dotfiles/local/bin` (dotfiles scripts)
+3. `~/.local/share/bob/nvim-bin` (Neovim)
+4. `~/.local/share/cargo/bin` (Rust tools like fd, rg)
+5. `/opt/homebrew/bin` (Homebrew packages)
+6. `/usr/local/bin` (system packages)
+
+## Shell Compatibility
+
+The dotfiles support multiple shells through `config/shared.sh`:
+
+- Functions prefixed with `x-` work across bash, zsh, and fish
+- Path management handled automatically per shell
+- Environment variables set appropriately per shell

.serena/memories/immediate_action_items.md

@@ -0,0 +1,114 @@
+# Immediate Action Items - Priority Order
+
+## HIGH PRIORITY (Must Fix Before Any Development)
+
+### 1. Fix Memory File Formatting (BLOCKING)
+
+```bash
+# These files prevent any linting from passing:
+- .serena/memories/code_style_conventions.md
+- .serena/memories/darwin_system_utilities.md
+- .serena/memories/project_overview.md
+- .serena/memories/project_structure.md
+- .serena/memories/suggested_commands.md
+- .serena/memories/task_completion_checklist.md
+
+# Issues: Missing final newlines, markdown formatting, line length
+# Impact: Blocks all linting commands
+```
+
+### 2. Fix Fish Shell Line Length Violations (BLOCKING)
+
+```bash
+# Files exceeding 80-char limit:
+config/fish/alias.fish (4 violations)
+config/fish/exports.fish (15 violations)
+
+# These are CRITICAL - Fish config has strict limits
+# Must be fixed before any fish-related changes
+```
+
+### 3. Fix Git Configuration Indentation (BLOCKING)
+
+```bash
+# Files with tab/space mixing:
+config/git/shared (40+ violations)
+hosts/s/config/git/overrides/config
+hosts/s/config/git/local.d/work-git
+
+# Impact: Git configuration may not work correctly
+```
+
+## MEDIUM PRIORITY (Fix During Next Development Cycle)
+
+### 4. Prettier Formatting Issues
+
+```bash
+# 17 files need prettier formatting:
+yarn fix:prettier
+# Most are JSON/YAML configuration files
+```
+
+### 5. WezTerm Color Scheme Indentation
+
+```bash
+# All files in config/wezterm/colors/ using tabs instead of spaces
+# Affects terminal appearance configuration
+```
+
+### 6. Update Linting Configuration
+
+```bash
+# Add shellcheck exclusions for submodules:
+# - tools/antidote/
+# - config/tmux/plugins/
+# - config/vim/extra/fzf/
+# - config/cheat/cheatsheets/tldr/
+```
+
+## LOW PRIORITY (Future Improvements)
+
+### 7. Test Infrastructure
+
+```bash
+# Fix bats test PATH issues
+# Tests pass but show rm command not found errors
+```
+
+### 8. Documentation Updates
+
+```bash
+# Add troubleshooting section to AGENTS.md
+# Create shellcheck exclusion documentation
+```
+
+## Immediate Commands to Run
+
+### Step 1: Auto-fix What's Possible
+
+```bash
+yarn fix:prettier    # Fix 17 files
+yarn fix:markdown    # Attempt markdown fixes
+```
+
+### Step 2: Manual Fixes Required
+
+- Add final newlines to all memory files
+- Wrap long lines in Fish configuration files
+- Convert tabs to spaces in Git configuration files
+
+### Step 3: Verify Progress
+
+```bash
+yarn lint:ec         # Check EditorConfig compliance
+yarn lint:markdown   # Check markdown issues
+yarn lint:prettier   # Check remaining prettier issues
+```
+
+## Success Criteria
+
+✅ `yarn lint` passes without errors
+✅ All EditorConfig violations resolved
+✅ Memory files properly formatted
+✅ Fish configuration under line limits
+✅ Git configuration uses consistent indentation

.serena/memories/project_overview.md

@@ -0,0 +1,60 @@
+# .dotfiles Project Overview
+
+## Purpose
+
+This is a comprehensive personal dotfiles repository for managing development
+environment configurations across macOS systems. The project uses **Dotbot** as
+the primary installation framework to manage symlinks and setup configurations.
+
+## Key Features
+
+- Automated configuration management using Dotbot
+- Support for multiple development tools and applications
+- Host-specific configurations in `/hosts/` directory
+- Comprehensive testing and linting setup with pre-commit hooks
+- Cross-shell compatibility (bash, zsh, fish)
+- Large collection of custom utility scripts in `local/bin/`
+- Git submodules for external tools (dotbot, antidote, tmux plugins)
+- Environment-specific configurations (secrets management)
+
+## Recent Notable Changes (from git status)
+
+- New everforest color theme configurations added
+- Multiple temporary fish configuration files present
+- Updates to various configuration files (.commitlintrc.json, .eslintrc.json, etc.)
+- New x-pr-comments script and documentation added
+- Various tmux plugin updates
+- Husky configuration relocated from base/ to config/husky/
+
+## Tech Stack
+
+- **Shell**: Bash (primary), with Fish and Zsh support
+- **Configuration Manager**: Dotbot with plugins (asdf, brew, include, pip)
+- **Package Manager**: Yarn 1.22.22 (Node.js), Homebrew (macOS), pipx (Python)
+- **Testing**: Bats test framework, custom test-all.sh script
+- **Linting**: MegaLinter, Prettier, ESLint, Markdownlint, ShellCheck, EditorConfig
+- **Automation**: Pre-commit hooks, GitHub Actions, Renovate
+
+## Project Structure Highlights
+
+- `/config/` - Main configuration directory (74+ subdirectories)
+- `/local/bin/` - Custom utility scripts (100+ scripts with documentation)
+- `/hosts/` - Host-specific configurations
+- `/tools/` - Git submodules for external tools
+- `/base/` - Base configuration files
+- `/secrets/` - Secret management configurations
+- `/scripts/` - Installation and setup scripts
+- `/.github/` - GitHub Actions workflows and configurations
+
+## Target System
+
+- **Platform**: Darwin (macOS) - Version 24.6.0
+- **Architecture**: Universal (Intel/Apple Silicon via Homebrew)
+- **Dependencies**: Git, Homebrew, Yarn, various CLI tools managed via mise
+
+## Development Environment
+
+- Node.js, Go, Python, Ruby, Rust managed via mise
+- Version files (.nvmrc, .go-version, .python-version) consumed by mise via idiomatic_version_file
+- Package management via Yarn with lockfile
+- TypeScript support for configuration files

.serena/memories/project_structure.md

@@ -0,0 +1,116 @@
+# Project Structure
+
+## Root Directory
+
+```text
+.dotfiles/
+├── install                 # Main installation script (Dotbot runner)
+├── install.conf.yaml      # Dotbot configuration
+├── package.json           # Node.js dependencies for linting/testing (Yarn managed)
+├── AGENTS.md              # Project documentation and guidelines
+├── test-all.sh            # Bats test runner
+├── add-submodules.sh      # Git submodule management
+└── .serena/               # Claude Code/Serena analysis cache (new)
+```
+
+## Main Directories
+
+### `config/` (74+ subdirectories)
+
+Configuration files for development tools and applications:
+
+- `git/` - Git configuration with delta integration and everforest theme
+- `nvim/` - Neovim configuration with Lua plugins
+- `tmux/` - Tmux configuration with multiple plugins (dark-notify, window-name, etc.)
+- `fish/` - Fish shell configuration with completions and functions
+- `zsh/` - Zsh configuration with antidote plugin manager
+- `fzf/` - Fuzzy finder configuration with everforest theme
+- `wezterm/` - WezTerm terminal configuration
+- `homebrew/` - Homebrew environment configuration
+- `starship.toml` - Starship prompt configuration
+- `shared.sh` - Cross-shell compatibility functions
+- `aerospace/`, `amethyst/`, `yabai/`, `skhd/` - Window managers
+- `direnv/`, `mise/`, `aqua/` - Development environment tools
+- `gpg-tui/`, `op/`, `gh/` - Security and CLI tools
+- Theme configurations: everforest color schemes across multiple tools
+
+### `base/`
+
+Dotfiles that get symlinked to home directory with `.` prefix:
+
+- Contains traditional dotfiles like `.bashrc`, `.zshrc`, etc.
+- `plan` - Planning/note-taking configuration
+- `shellcheckrc` - ShellCheck rules
+
+### `local/`
+
+- `bin/` - 100+ custom scripts with comprehensive documentation
+  - Homegrown utilities (dfm, git tools, backup scripts, etc.)
+  - Sourced utilities (from skx/sysadmin-util, mvdan/dotfiles)
+  - Each script has corresponding .md documentation
+  - Recent additions: x-pr-comments for GitHub PR analysis
+- `share/fonts/` - JetBrains Mono font files
+- `man/` - Manual pages
+
+### `ssh/`
+
+SSH configuration files (mode 0600/0700)
+
+- `shared.d/` - Shared SSH configurations for specific hosts
+
+### `tools/` (Git submodules)
+
+External tools and Dotbot plugins:
+
+- `dotbot/` - Dotbot installation framework
+- `dotbot-*` - Dotbot plugins (asdf, brew, include, pip)
+- `antidote/` - Zsh plugin manager
+- Various tmux plugins (continuum, resurrect, yank, etc.)
+
+### `hosts/`
+
+Host-specific configurations:
+
+- `air/`, `s/`, `v/` - Individual host configurations
+- Applied after main configuration
+
+### `secrets/`
+
+Secret and credential management configuration
+
+### `scripts/`
+
+Installation and setup automation scripts
+
+### `.github/`
+
+- GitHub Actions workflows
+- Renovate configuration
+- Issue templates and documentation
+
+### Development Configuration Files
+
+- `.editorconfig` - Editor configuration rules
+- `.prettierrc.js` - Prettier formatting rules
+- `.eslintrc.json` - ESLint linting rules
+- `.commitlintrc.json` - Commit message linting
+- `.shellcheckrc` - ShellCheck configuration
+- `.mega-linter.yml` - MegaLinter configuration
+- `.luarc.json` - Lua language server configuration
+- `.nvmrc`, `.go-version`, `.python-version` - Version files (consumed by mise)
+- Various ignore files (.gitignore, .prettierignore, .yamlignore, etc.)
+
+## Testing Infrastructure
+
+- `tests/` - Bats test files
+- `test-all.sh` - Main test runner
+- Pre-commit hooks for automated testing
+- GitHub Actions for CI/CD
+
+## Recent Structural Changes
+
+- Husky configuration moved from `base/huskyrc` to `config/husky/init.sh`
+- Addition of everforest theme configurations across multiple tools
+- New .serena directory for AI analysis caching
+- Multiple temporary fish configuration files (everforest themes)
+- Enhanced git configuration with delta and everforest theming

.serena/memories/shellcheck_issues.md

@@ -0,0 +1,62 @@
+# ShellCheck Issues Analysis
+
+## Critical Shell Script Problems
+
+### Missing Shebangs (SC2148)
+
+Multiple shell scripts missing proper shebang lines:
+
+- `tools/antidote/tests/` - Test scripts
+- `config/vim/*/test/lib/common.sh` - FZF test libraries
+- `config/tmux/plugins/*/scripts/helpers.sh` - Plugin helper scripts
+- Various submodule scripts
+
+### Syntax Errors (SC1036, SC1088, SC1073)
+
+- `config/vim/fzf/test/lib/common.sh` - Invalid ERB template syntax
+- `config/cheat/cheatsheets/tldr/` - Markdown files incorrectly parsed as shell
+- `tmux-sessionist/scripts/list_sessions.sh` - Brace parsing errors
+
+### Variable Assignment Issues (SC1007, SC2155)
+
+- `config/vim/extra/fzf/test/lib/common.sh` - Incorrect empty variable assignments
+- Multiple tmux plugin scripts - Declare and assign should be separate
+
+### Quoting Problems (SC2086, SC2006)
+
+- Unquoted variable expansions in tmux plugin scripts
+- Legacy backtick usage instead of $(...) syntax
+- Missing quotes around variable expansions
+
+## Third-Party Code Issues
+
+### Submodule Problems
+
+Most shellcheck errors are in **third-party submodules**:
+
+- `tools/antidote/` - Zsh plugin manager
+- `config/tmux/plugins/` - Tmux plugins
+- `config/vim/extra/fzf/` - FZF integration
+- `config/cheat/cheatsheets/tldr/` - Cheat sheet collection
+
+### Recommendation
+
+- These should be **excluded from shellcheck** via configuration
+- Focus linting only on **project-owned scripts**
+- Add shellcheck ignore patterns for submodule directories
+
+## Project-Owned Script Issues
+
+### Main Scripts Status
+
+- `install` - ✅ Clean (no shellcheck errors)
+- `test-all.sh` - ✅ Clean
+- `add-submodules.sh` - ✅ Clean
+- `config/shared.sh` - ✅ Clean
+- Scripts in `local/bin/` - ✅ Mostly clean
+
+### Minor Issues Found
+
+- Some scripts could benefit from stricter quoting
+- Consistent shebang usage across all scripts
+- Consider adding `set -euo pipefail` to more scripts

.serena/memories/suggested_commands.md

@@ -0,0 +1,122 @@
+# Essential Commands for .dotfiles Development
+
+## Installation & Setup
+
+```bash
+# Initial setup - install linting tools and dependencies
+yarn install
+
+# Install/update all dotfiles configurations
+./install
+
+# Update git submodules (multiple approaches)
+git submodule update --remote --merge
+git submodule update --init --recursive --force
+bash add-submodules.sh
+```
+
+## Development Commands
+
+```bash
+# Linting (run all linters - ALWAYS fix all issues)
+yarn lint
+
+# Individual linting commands
+yarn lint:markdown    # Markdownlint
+yarn lint:prettier    # Prettier check
+yarn lint:ec          # EditorConfig checker
+
+# Auto-fixing (use these BEFORE manual linting)
+yarn fix              # Fix all format issues
+yarn fix:markdown     # Fix markdown formatting
+yarn fix:prettier     # Fix prettier formatting
+
+# Testing
+yarn test             # Run all Bats tests
+bash test-all.sh      # Alternative test runner
+```
+
+## Pre-commit Hooks (Comprehensive)
+
+Current pre-commit configuration includes:
+
+- **Security**: detect-aws-credentials, detect-private-key
+- **File integrity**: check-case-conflict, check-merge-conflict, check-symlinks
+- **Shell scripts**: shellcheck, shfmt (formatting)
+- **YAML/JSON**: yamllint, check-yaml, check-toml, pretty-format-json
+- **Markdown**: markdownlint with auto-fix
+- **Lua**: stylua formatting for Neovim configs
+- **Fish**: fish_syntax, fish_indent for shell configs
+- **GitHub Actions**: actionlint validation
+- **Renovate**: renovate-config-validator
+- **General**: trailing-whitespace, end-of-file-fixer, mixed-line-ending
+
+```bash
+# Run pre-commit manually
+pre-commit run --all-files
+```
+
+## Version Management
+
+```bash
+# Check current versions (all managed by mise)
+node --version        # mise (.nvmrc via idiomatic_version_file)
+go version           # mise (.go-version)
+python --version     # mise (.python-version)
+mise ls              # List all installed tool versions
+```
+
+## System Utilities (Darwin-specific)
+
+```bash
+# Modern CLI tools available
+ls                   # aliased to eza with icons and git info
+grep                 # aliased to grep --color
+fd pattern           # modern find alternative
+rg pattern           # ripgrep for text search
+bat file            # modern cat with syntax highlighting
+```
+
+## Project-specific Scripts (100+ available)
+
+```bash
+# Dotfiles management
+bash local/bin/dfm install all
+
+# Git utilities
+git-dirty            # Check for dirty git repositories
+git-fsck-dirs        # Run fsck on git directories
+git-update-dirs      # Update multiple git directories
+
+# Development utilities
+x-pr-comments <pr>   # Analyze GitHub PR comments (NEW)
+x-set-php-aliases    # Generate PHP version aliases
+x-env-list          # List environment variables
+x-open-ports        # Check open network ports
+
+# Backup utilities
+x-backup-folder     # Backup directories
+x-backup-mysql-with-prefix  # MySQL backup with prefix
+```
+
+## Configuration Management
+
+```bash
+# Load shell configurations
+source config/shared.sh      # Cross-shell compatibility functions
+source x-set-php-aliases     # PHP version management
+
+# Host-specific configurations
+# Automatically applied: hosts/{hostname}/
+```
+
+## Quality Assurance (CRITICAL)
+
+**All linting errors are BLOCKING and must be fixed:**
+
+- EditorConfig violations are considered blocking errors
+- ShellCheck warnings must be addressed
+- Prettier formatting must be consistent
+- Markdownlint rules must be followed
+- NEVER use --no-verify with git operations
+- ALWAYS run autofixers before manual intervention

.serena/memories/task_completion_checklist.md

@@ -0,0 +1,115 @@
+# Task Completion Checklist
+
+When completing any development task in this dotfiles repository, follow this
+checklist to ensure compliance with project standards.
+
+## Required Steps (BLOCKING)
+
+### 1. Code Quality Checks
+
+```bash
+# Run all linting tools - MUST PASS with zero errors
+yarn lint
+
+# Individual checks if needed:
+yarn lint:markdown    # Markdownlint validation
+yarn lint:prettier    # Prettier formatting check
+yarn lint:ec          # EditorConfig compliance verification
+```
+
+### 2. Shell Script Validation (if applicable)
+
+```bash
+# All shell scripts must pass shellcheck without warnings
+find . -path ./node_modules -prune -o -name '*.sh' -print0 | xargs -0 shellcheck
+
+# For individual scripts:
+shellcheck path/to/script.sh
+```
+
+### 3. Testing Infrastructure
+
+```bash
+# Run all tests - MUST PASS completely
+yarn test
+# OR alternative runner
+bash test-all.sh
+
+# For specific test categories:
+# Bats tests in tests/ directory
+# Individual script functionality tests
+```
+
+### 4. EditorConfig Compliance (CRITICAL)
+
+- **BLOCKING REQUIREMENT**: EditorConfig violations prevent completion
+- All code must follow `.editorconfig` rules exactly:
+  - UTF-8 charset
+  - LF line endings
+  - Final newline required
+  - Trailing whitespace removal
+  - Language-specific indentation (2-space default, 4-space for Fish)
+- Use autofixers before attempting manual fixes
+- Never modify linting configuration to bypass errors
+
+## Auto-fixing Protocol
+
+```bash
+# ALWAYS run auto-fixers first, in this order:
+yarn fix              # Fix all auto-fixable issues
+yarn fix:markdown     # Fix markdown formatting violations
+yarn fix:prettier     # Fix code formatting issues
+
+# Verify fixes applied correctly:
+yarn lint             # Should show reduced error count
+```
+
+## Pre-commit Hook Integration
+
+Current pre-commit configuration enforces:
+
+- Security checks (credentials, private keys)
+- Shell script validation (shellcheck, shfmt)
+- Markdown formatting (markdownlint with auto-fix)
+- YAML/JSON validation and formatting
+- Lua formatting (stylua for Neovim configs)
+- Fish shell syntax validation
+- GitHub Actions validation (actionlint)
+- Renovate configuration validation
+
+## Memory File Maintenance
+
+When updating memory files:
+
+1. Follow markdown best practices (blank lines around headings/lists)
+2. Specify language for fenced code blocks
+3. Ensure final newline exists
+4. Respect line length limits (120 chars for markdown)
+5. Use proper heading hierarchy
+
+## Critical Success Criteria
+
+✅ **REQUIRED FOR TASK COMPLETION:**
+
+- `yarn lint` exits with code 0 (no errors)
+- `yarn test` passes all test suites
+- EditorConfig compliance verified
+- No trailing whitespace or missing final newlines
+- Shell scripts have proper shebangs and pass shellcheck
+- All temporary/cache files cleaned up
+
+❌ **BLOCKING ISSUES:**
+
+- Any linting errors or warnings
+- EditorConfig violations of any kind
+- Test failures or incomplete test coverage
+- Use of `--no-verify` flag with git operations
+- Modified linting configurations to bypass errors
+
+## Quality Assurance Notes
+
+- **Use `which command`** to get full paths in scripts
+- **Prefer modern tools**: `rg` over `grep`, `fd` over `find`, `bat` over `cat`
+- **Test cross-shell compatibility**: bash, zsh, fish
+- **Validate host-specific configurations** don't break general setup
+- **Document any new utilities** in `local/bin/README.md`

.serena/project.yml

@@ -0,0 +1,160 @@
+---
+# whether to use the project's gitignore file to ignore files
+# Added on 2025-04-07
+ignore_all_files_in_gitignore: true
+# list of additional paths to ignore
+# same syntax as gitignore, so you can use * and **
+# Was previously called `ignored_dirs`, please update your config if you are using that.
+# Added (renamed) on 2025-04-07
+ignored_paths:
+  - "*.swp"
+  - "*.tmp"
+  - "*.tmp.*"
+  - ".DS_Store"
+  - ".git/**"
+  - /config/cheat/cheatsheets/community/**
+  - /config/cheat/cheatsheets/pure-bash-bible/**
+  - /config/cheat/cheatsheets/tldr/**
+  - /config/fish/cheatsheets/community/**
+  - /config/fzf/**
+  - /config/nvim/snippets/**
+  - /config/nvim/spell/**
+  - /config/op/plugins/**
+  - /config/tmux/plugins/**
+  - /config/vim/extra/**
+  - /config/zsh/completions/**
+  - /config/zsh/plugins/**
+  - /local/man/fzf
+  - /local/share/fonts
+  - /tools/antidote
+  - /tools/dotbot
+  - /tools/dotbot-*/**
+  - node_modules/**
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions,
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+# the name by which the project can be referenced within Serena
+project_name: ".dotfiles"
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default).
+# This extends the existing inclusions (e.g. from the global configuration).
+included_optional_tools: []
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# time budget (seconds) per tool call for the retrieval of additional symbol information
+# such as docstrings or parameter information.
+# This overrides the corresponding setting in the global configuration; see the documentation there.
+# If null or missing, use the setting from the global configuration.
+symbol_info_budget:
+
+# The language backend to use for this project.
+# If not set, the global setting from serena_config.yml is used.
+# Valid values: LSP, JetBrains
+# Note: the backend is fixed at startup. If a project with a different backend
+# is activated post-init, an error will be returned.
+language_backend:
+
+# line ending convention to use when writing source files.
+# Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default)
+# This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings.
+line_ending:
+
+# list of regex patterns which, when matched, mark a memory entry as read‑only.
+# Extends the list from the global configuration, merging the two lists.
+read_only_memory_patterns: []
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: utf-8
+
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   php_phpactor        powershell          python              python_jedi         r
+#   rego                ruby                ruby_solargraph     rust                scala
+#   swift               terraform           toml                typescript          typescript_vts
+#   vue                 yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   Some languages require additional setup/installations.
+#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+  - bash
+  - lua

.sonarlint/connectedMode.json

@@ -0,0 +1,5 @@
+{
+  "sonarCloudOrganization": "ivuorinen",
+  "projectKey": "ivuorinen_dotfiles",
+  "region": "EU"
+}

.yamlignore

@@ -0,0 +1,16 @@
+# vim: ft=gitignore
+.mypy_cache/*
+Brewfile.lock.json
+config/cheat/cheatsheets/community
+config/cheat/cheatsheets/tldr
+config/fzf/*
+config/nvim/*
+config/op/plugins/used_plugins/*
+config/tmux/plugins/*
+config/vim/plugged/*
+config/zsh/*
+lazy-lock.json
+local/bin/antigen.zsh
+local/bin/asdf
+tools/antidote/*
+tools/dotbot*

.yamllint.yml

@@ -0,0 +1,21 @@
+---
+extends: default
+
+ignore: |
+  node_modules
+  tools
+  config/tmux/plugins
+
+rules:
+  empty-lines:
+    level: warning
+    max: 1
+  line-length:
+    max: 200
+    level: warning
+  truthy:
+    check-keys: false
+  comments:
+    min-spaces-from-content: 1
+  trailing-spaces:
+    level: warning

.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

CLAUDE.md

@@ -0,0 +1,277 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code)
+when working with code in this repository.
+
+## Repository Overview
+
+Personal dotfiles repository for Ismo Vuorinen.
+Uses **Dotbot** (not GNU Stow) to symlink configuration files into place.
+The directory layout follows the XDG Base Directory Specification.
+
+## Directory Layout and Linking
+
+| Source              | Destination       | Notes                                     |
+|---------------------|-------------------|-------------------------------------------|
+| `base/*`            | `~/.*`            | Home-level dotfiles (`.` added by Dotbot) |
+| `config/*`          | `~/.config/`      | Application configurations                |
+| `local/bin/*`       | `~/.local/bin/`   | Helper scripts and utilities              |
+| `local/share/*`     | `~/.local/share/` | Data files                                |
+| `local/man/**`      | `~/.local/man/`   | Manual pages                              |
+| `ssh/*`             | `~/.ssh/`         | SSH configuration (mode 0600)             |
+| `hosts/<hostname>/` | Overlays          | Host-specific overrides                   |
+
+Installation: `./install` runs Dotbot with `install.conf.yaml`,
+then applies `hosts/<hostname>/install.conf.yaml` if it exists.
+
+## Commands
+
+```bash
+# Install dependencies (required before lint/test)
+yarn install
+
+# Linting
+yarn lint              # Run biome + prettier + editorconfig-checker
+yarn lint:biome        # Biome only
+yarn lint:ec           # EditorConfig checker only
+yarn lint:md-table     # Markdown table formatting check
+yarn fix:md-table      # Auto-fix markdown tables
+
+# Formatting
+yarn fix:biome         # Autofix with biome (JS/TS/JSON/MD)
+yarn fix:prettier      # Autofix with prettier (YAML)
+yarn format            # Format with biome
+yarn format:yaml       # Format YAML files with prettier
+
+# Testing (Bats - Bash Automated Testing System)
+yarn test              # Run all tests in tests/
+# Run a single test file:
+./node_modules/.bin/bats tests/dfm.bats
+
+# Shell linting
+shellcheck <script>    # Lint shell scripts
+
+# Tooling maintenance
+npx @biomejs/biome migrate --write  # Update biome schema version
+```
+
+## Pre-commit Hooks
+
+Configured in `.pre-commit-config.yaml`: shellcheck, shfmt, biome,
+yamllint, prettier, actionlint, stylua, fish_syntax/fish_indent, ruff.
+Run `pre-commit run --all-files` to check everything.
+
+## Commit Convention
+
+Semantic Commit messages: `type(scope): summary`
+(e.g., `fix(tmux): correct prefix binding`).
+Enforced by commitlint extending `@ivuorinen/commitlint-config`.
+
+## Architecture
+
+### Shell Configuration Chain
+
+Both `base/bashrc` and `base/zshrc` source `config/shared.sh`,
+which loads:
+- `config/exports` — environment variables, XDG dirs, PATH
+- `config/alias` — shell aliases
+
+Zsh additionally uses **antidote** (in `tools/antidote/`)
+for plugin management and **oh-my-posh** for the prompt.
+
+### msgr — Messaging Helper
+
+`local/bin/msgr` provides colored output functions (`msgr msg`,
+`msgr run`, `msgr yay`, `msgr err`, `msgr warn`). Sourced by `dfm`
+and most scripts in `local/bin/`.
+
+### dfm — Dotfiles Manager
+
+`local/bin/dfm` is the main management script. Key commands:
+- `dfm install all` — install everything in tiered stages
+- `dfm brew install` / `dfm brew update` — Homebrew management
+- `dfm apt upkeep` — APT package maintenance (Debian/Ubuntu)
+- `dfm dotfiles fmt` / `dfm dotfiles shfmt` — format configs/scripts
+- `dfm helpers <name>` — inspect aliases, colors, env, functions, path
+- `dfm docs all` — regenerate documentation under `docs/`
+- `dfm check arch` / `dfm check host` — system info
+- `dfm scripts` — run scripts from `scripts/` (discovered via `@description` tags)
+- `dfm tests` — test visualization helpers
+
+### mise — Unified Tool Manager
+
+`config/mise/config.toml` manages language runtimes (Node LTS, Python 3,
+Go latest, Rust stable) and CLI tools (fd, ripgrep, eza, neovim, delta,
+zoxide, etc.). Activated via `eval "$(mise activate bash)"` in
+`config/exports`. Run `mise install` after adding new tools.
+
+### Submodules
+
+External dependencies are git submodules (Dotbot, plugins,
+tmux plugins, cheatsheets, antidote).
+Managed by `add-submodules.sh`. All set to `ignore = dirty`.
+Updated automatically via GitHub Actions on a schedule.
+
+### Host-specific Configs
+
+Machine-specific overrides live in `hosts/<hostname>/`
+with their own `base/`, `config/`, and `install.conf.yaml`.
+These are layered on top of the global config during installation.
+
+## Code Style
+
+- **EditorConfig**: 2-space indent, UTF-8, LF line endings.
+  See `.editorconfig` for per-filetype overrides
+  (4-space for PHP/fish, tabs for git config).
+- **Shell scripts**: Must have a shebang or
+  `# shellcheck shell=bash` directive.
+  Follow shfmt settings in `.editorconfig`
+  (2-space indent, `binary_next_line`,
+  `switch_case_indent`, `space_redirects`, `function_next_line`).
+- **Lua** (neovim config): Formatted with stylua (`stylua.toml`),
+  90-char line length.
+- **JSON/JS/TS/Markdown**: Formatted with Biome (`biome.json`),
+  80-char width (Markdown uses 120-char override).
+- **YAML**: Formatted with Prettier (`.prettierrc.json`),
+  validated with yamllint (`.yamllint.yml`).
+
+## ShellCheck Disabled Rules
+
+Defined in `.shellcheckrc`:
+SC2039 (POSIX `local`), SC2166 (`-o` in test),
+SC2154 (unassigned variables), SC1091 (source following),
+SC2174 (mkdir -p -m), SC2016 (single-quote expressions).
+
+## Gotchas
+
+- **POSIX scripts**: `x-ssh-audit`, `x-codeql`, `x-until-error`,
+  `x-until-success`, `x-ssl-expiry-date` use `/bin/sh`.
+  Validate with `sh -n`, not `bash -n`.
+- **Vendor file**: `local/bin/fzf-tmux` is vendored from
+  junegunn/fzf — do not modify.
+- **Fish config**: `config/fish/` has its own config chain
+  (`config.fish`, `exports.fish`, `alias.fish`) plus 60+ functions.
+- **gh CLI config**: `config/gh/hosts.yml` is managed by `gh` CLI
+  and excluded from prettier (see `.prettierignore`).
+- **Python**: Two scripts (`x-compare-versions.py`,
+  `x-git-largest-files.py`) linted by Ruff (config in `pyproject.toml`).
+- **Fish secrets**: `config/fish/secrets.d/*.fish` files are auto-sourced
+  by `exports.fish`. Copy `github.fish.example` → `github.fish` for local
+  secrets. These files are gitignored; only `*.example` and `README.md`
+  are tracked.
+
+## Claude Code Configuration
+
+- **Hooks** (`.claude/settings.json`):
+  - *PreToolUse*: Blocks edits to `fzf-tmux`, `yarn.lock`,
+    `.yarn/`, submodule paths, and real secrets.d files
+  - *PostToolUse*: Auto-formats files by extension
+    (shfmt, fish_indent, stylua, biome, prettier)
+  - *PostToolUse*: Validates Dotbot `install.conf.yaml`
+    after edits
+  - *PostToolUse*: Warns on formatter/linter config changes
+  - *Stop*: Runs `yarn lint` gate before finishing
+- **Skills** (`.claude/skills/`):
+  - `shell-validate`: Auto-validates shell scripts
+    (syntax + shellcheck)
+  - `fish-validate`: Auto-validates fish scripts
+    (syntax + fish_indent)
+  - `lua-format`: Auto-formats Lua files with stylua
+  - `yaml-validate`: Auto-validates YAML files
+    (yamllint + actionlint)
+  - `dotbot-validate`: Validates Dotbot install.conf.yaml
+  - `new-script`: Scaffolds helper scripts in local/bin/
+  - `new-fish-function`: Scaffolds fish functions
+  - `host-override`: Creates host-specific config overlays
+- **Subagents** (`.claude/agents/`):
+  - `code-reviewer`: Reviews shell/fish/lua changes
+- **Plugins** (required):
+  - `context-mode`: Context window protection — must be
+    installed for this repo. See routing rules below.
+  - `context7`: Live documentation lookup
+
+## Package Manager
+
+Yarn (v4+) is the package manager. Do not use npm.
+
+# context-mode — MANDATORY routing rules
+
+You have context-mode MCP tools available. These rules are NOT optional —
+they protect your context window from flooding. A single unrouted command
+can dump 56 KB into context and waste the entire session.
+
+## BLOCKED commands — do NOT attempt these
+
+### curl / wget — BLOCKED
+Any Bash command containing `curl` or `wget` is intercepted and replaced with an error message. Do NOT retry.
+Instead use:
+- `ctx_fetch_and_index(url, source)` to fetch and index web pages
+- `ctx_execute(language: "javascript", code: "const r = await fetch(...)")` to run HTTP calls in sandbox
+
+### Inline HTTP — BLOCKED
+Any Bash command containing `fetch('http`, `requests.get(`,
+`requests.post(`, `http.get(`, or `http.request(` is intercepted
+and replaced with an error message. Do NOT retry with Bash.
+Instead use:
+- `ctx_execute(language, code)` to run HTTP calls in sandbox — only stdout enters context
+
+### WebFetch — BLOCKED
+WebFetch calls are denied entirely. The URL is extracted and you are told to use `ctx_fetch_and_index` instead.
+Instead use:
+- `ctx_fetch_and_index(url, source)` then `ctx_search(queries)` to query the indexed content
+
+## REDIRECTED tools — use sandbox equivalents
+
+### Bash (>20 lines output)
+Bash is ONLY for: `git`, `mkdir`, `rm`, `mv`, `cd`, `ls`, `npm install`, `pip install`, and other short-output commands.
+For everything else, use:
+- `ctx_batch_execute(commands, queries)` — run multiple commands + search in ONE call
+- `ctx_execute(language: "shell", code: "...")` — run in sandbox, only stdout enters context
+
+### Read (for analysis)
+If you are reading a file to **Edit** it → Read is correct (Edit needs content in context).
+If you are reading to **analyze, explore, or summarize** →
+use `ctx_execute_file(path, language, code)` instead. Only your
+printed summary enters context. The raw file stays in the sandbox.
+
+### Grep (large results)
+Grep results can flood context.
+Use `ctx_execute(language: "shell", code: "grep ...")` to run
+searches in sandbox. Only your printed summary enters context.
+
+## Tool selection hierarchy
+
+1. **GATHER**: `ctx_batch_execute(commands, queries)` — Primary
+  tool. Runs all commands, auto-indexes output, returns search
+  results. ONE call replaces 30+ individual calls.
+2. **FOLLOW-UP**: `ctx_search(queries: ["q1", "q2", ...])` —
+  Query indexed content. Pass ALL questions as array in ONE call.
+3. **PROCESSING**: `ctx_execute(language, code)` |
+  `ctx_execute_file(path, language, code)` — Sandbox execution.
+  Only stdout enters context.
+4. **WEB**: `ctx_fetch_and_index(url, source)` then
+  `ctx_search(queries)` — Fetch, chunk, index, query.
+  Raw HTML never enters context.
+5. **INDEX**: `ctx_index(content, source)` — Store content in FTS5 knowledge base for later search.
+
+## Subagent routing
+
+When spawning subagents (Agent/Task tool), the routing block is
+automatically injected into their prompt. Bash-type subagents are
+upgraded to general-purpose so they have access to MCP tools.
+You do NOT need to manually instruct subagents about context-mode.
+
+## Output constraints
+
+- Keep responses under 500 words.
+- Write artifacts (code, configs, PRDs) to FILES — never return
+  them as inline text. Return only: file path + 1-line description.
+- When indexing content, use descriptive source labels so others can `ctx_search(source: "label")` later.
+
+## ctx commands
+
+| Command       | Action                                                                                |
+|---------------|---------------------------------------------------------------------------------------|
+| `ctx stats`   | Call the `ctx_stats` MCP tool and display the full output verbatim                    |
+| `ctx doctor`  | Call the `ctx_doctor` MCP tool, run the returned shell command, display as checklist  |
+| `ctx upgrade` | Call the `ctx_upgrade` MCP tool, run the returned shell command, display as checklist |

add-submodules.sh

@@ -5,12 +5,8 @@ git submodule sync --recursive
 # dotbot and plugins
 git submodule add --name dotbot \
   -f https://github.com/anishathalye/dotbot.git tools/dotbot
-git submodule add --name dotbot-brew \
-  -f https://github.com/wren/dotbot-brew.git tools/dotbot-brew
 git submodule add --name dotbot-include \
   -f https://gitlab.com/gnfzdz/dotbot-include.git tools/dotbot-include
-git submodule add --name dotbot-pip \
-  -f https://github.com/sobolevn/dotbot-pip.git tools/dotbot-pip
 
 # other repos
 git submodule add --name cheat-community \
@@ -24,24 +20,18 @@ git submodule add --name antidote \
 # tmux plugin manager and plugins
 git submodule add --name tmux/tmux-continuum \
   -f https://github.com/tmux-plugins/tmux-continuum config/tmux/plugins/tmux-continuum
-git submodule add --name tmux/tmux-mode-indicator \
-  -f https://github.com/MunifTanjim/tmux-mode-indicator.git config/tmux/plugins/tmux-mode-indicator
 git submodule add --name tmux/tmux-resurrect \
   -f https://github.com/tmux-plugins/tmux-resurrect.git config/tmux/plugins/tmux-resurrect
-git submodule add --name tmux/tmux-sensible \
-  -f https://github.com/tmux-plugins/tmux-sensible.git config/tmux/plugins/tmux-sensible
 git submodule add --name tmux/tmux-sessionist \
   -f https://github.com/tmux-plugins/tmux-sessionist.git config/tmux/plugins/tmux-sessionist
 git submodule add --name tmux/tmux-suspend \
   -f https://github.com/MunifTanjim/tmux-suspend.git config/tmux/plugins/tmux-suspend
-git submodule add --name tmux/tmux-window-name \
-  -f https://github.com/ivuorinen/tmux-window-name.git config/tmux/plugins/tmux-window-name
-git submodule add --name tmux/tmux-yank \
-  -f https://github.com/tmux-plugins/tmux-yank.git config/tmux/plugins/tmux-yank
 git submodule add --name tmux/tmux-current-pane-hostname \
   -f https://github.com/soyuka/tmux-current-pane-hostname.git config/tmux/plugins/tmux-current-pane-hostname
 git submodule add --name tmux/tmux-dark-notify \
-  -f https://github.com/erikw/tmux-dark-notify.git config/tmux/plugins/tmux-dark-notify
+  -f https://github.com/ivuorinen/tmux-dark-notify.git config/tmux/plugins/tmux-dark-notify
+git submodule add --name tmux/catppuccin \
+  -f https://github.com/catppuccin/tmux.git config/tmux/plugins/catppuccin
 
 # Takes submodules and sets them to ignore all changes
 for MODULE in $(git config --file .gitmodules --get-regexp path | awk '{ print $2 }'); do
@@ -52,21 +42,70 @@ done
 # Mark certain repositories shallow
 git config -f .gitmodules submodule.antidote.shallow true
 
-# remove old submodules
-folders=(
-  "config/tmux/plugins/tpm"
-  "config/tmux/plugins/tmux"
-  "config/tmux/plugins/tmux-menus"
-  "tools/dotbot-crontab"
-  "tools/dotbot-snap"
-  "config/nvim-kickstart"
-  "local/bin/asdf"
-  "local/asdf"
-  "tools/dotbot-asdf"
+# Log a message using msgr if available, else echo
+_log()
+{
+  local msg="$1"
+  if command -v msgr > /dev/null 2>&1; then
+    msgr run_done "$msg"
+  else
+    echo "  [ok] $msg"
+  fi
+  return 0
+}
+
+# Remove a stale git submodule and clean up references
+remove_old_submodule()
+{
+  local name="$1" path="$2"
+
+  # Remove working tree
+  if [[ -d "$path" ]]; then
+    rm -rf "$path"
+    _log "Removed $path"
+  fi
+
+  # Remove stale git index entry
+  git rm --cached "$path" 2> /dev/null || true
+
+  # Remove .git/config section keyed by path
+  git config --remove-section "submodule.$path" 2> /dev/null || true
+
+  # Skip name-based cleanup if no submodule name provided
+  [[ -z "$name" ]] && return 0
+
+  # Remove .git/config section keyed by name
+  git config --remove-section "submodule.$name" 2> /dev/null || true
+
+  # Remove .git/modules/<name>/ cached repository
+  if [[ -d ".git/modules/$name" ]]; then
+    rm -rf ".git/modules/$name"
+    _log "Removed .git/modules/$name"
+  fi
+}
+
+# remove old submodules (name:path pairs)
+old_submodules=(
+  "tmux/tpm:config/tmux/plugins/tpm"
+  ":config/tmux/plugins/tmux"
+  "tmux/tmux-menus:config/tmux/plugins/tmux-menus"
+  "dotbot-crontab:tools/dotbot-crontab"
+  "dotbot-snap:tools/dotbot-snap"
+  "tmux/tmux-window-name:config/tmux/plugins/tmux-window-name"
+  "tmux/tmux-sensible:config/tmux/plugins/tmux-sensible"
+  "tmux/tmux-mode-indicator:config/tmux/plugins/tmux-mode-indicator"
+  "tmux/tmux-yank:config/tmux/plugins/tmux-yank"
+  ":config/tmux/plugins/tmux-fzf-url"
+  "nvim-kickstart:config/nvim-kickstart"
+  "asdf:local/bin/asdf"
+  "asdf:local/asdf"
+  "dotbot-asdf:tools/dotbot-asdf"
+  "dotbot-pip:tools/dotbot-pip"
+  "dotbot-brew:tools/dotbot-brew"
 )
 
-for folder in "${folders[@]}"; do
-  [ -d "$folder" ] \
-    && rm -rf "$folder" \
-    && msgr run_done "Removed old submodule $folder"
+for entry in "${old_submodules[@]}"; do
+  name="${entry%%:*}"
+  path="${entry#*:}"
+  remove_old_submodule "$name" "$path"
 done

base/bashrc

@@ -2,20 +2,17 @@
 # shellcheck shell=bash
 
 export DOTFILES="$HOME/.dotfiles"
+# Minimal PATH for x-have and utilities; full PATH set in shared.sh/exports
 export PATH="$HOME/.local/bin:$DOTFILES/local/bin:$PATH"
 export SHARED_SCRIPTS_SOURCED=0
 
 source "$DOTFILES/config/shared.sh"
 
-if [ -n "${GHOSTTY_RESOURCES_DIR}" ]; then
-  builtin source "${GHOSTTY_RESOURCES_DIR}/shell-integration/bash/ghostty.bash"
-fi
-
 # shellcheck source=../config/fzf/fzf.bash
 [ -f "${DOTFILES}/config/fzf/fzf.bash" ] &&
   source "${DOTFILES}/config/fzf/fzf.bash"
 
-# Import ssh keys in keychain
+# Import ssh keys in keychain (macOS-specific -A flag, silently fails on Linux)
 ssh-add -A 2>/dev/null
 
 x-have antidot && {
@@ -25,6 +22,3 @@ x-have antidot && {
 PROMPT_DIRTRIM=3
 PROMPT_COMMAND='PS1_CMD1=$(git branch --show-current 2>/dev/null)'
 PS1='\[\e[95m\]\u\[\e[0m\]@\[\e[38;5;22;2m\]\h\[\e[0m\] \[\e[38;5;33m\]\w\[\e[0m\] \[\e[92;2m\]${PS1_CMD1}\n\[\e[39m\]➜\[\e[0m\] '
-
-# Added by LM Studio CLI (lms)
-export PATH="$PATH:$HOME/.lmstudio/bin"

base/envrc

@@ -1 +0,0 @@
-use node

base/gitprofile

@@ -20,6 +20,16 @@
         "value": "Ismo Vuorinen"
       }
     ],
+    "masf": [
+      {
+        "key": "user.email",
+        "value": "ismo@masf.fi"
+      },
+      {
+        "key": "user.name",
+        "value": "Ismo Vuorinen"
+      }
+    ],
     "work": [
       {
         "key": "user.email",

base/hammerspoon/.luacheckrc

@@ -0,0 +1,15 @@
+--
+-- These globals can be set and accessed:
+--
+globals = {
+  "rawrequire",
+}
+
+--
+-- These globals can only be accessed:
+--
+read_globals = {
+  "hs",
+  "ls",
+  "spoon",
+}

base/hammerspoon/init.lua

@@ -0,0 +1,205 @@
+-- ╭─────────────────────────────────────────────────────────╮
+-- │                 Hammerspoon config file                 │
+-- ╰─────────────────────────────────────────────────────────╯
+-- init.lua — Pure Hammerspoon window controls
+-- Converted from skhdrc logic; expanded with per‑display grids,
+-- app rules with groups, wrap‑around focus, cross‑display moves,
+-- and overlay/notification toggles.
+-- Author: Ismo Vuorinen (ivuorinen)
+
+--------------------------------------------------
+-- Caps Lock as Meh key (Shift+Control+Alt)
+--------------------------------------------------
+-- Prerequisites:
+-- 1. Go to System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys
+-- 2. Set Caps Lock to "No Action" (you mentioned you already did this)
+-- 3. Install Karabiner-Elements: brew install --cask karabiner-elements
+-- 4. Open Karabiner-Elements, go to "Simple Modifications"
+-- 5. Add: caps_lock → f18
+--
+-- Then you can use F18 as your Meh key in Hammerspoon:
+local f18 = hs.hotkey.modal.new()
+
+-- Capture F18 key press/release
+hs.hotkey.bind({}, 'F18', function()
+  f18:enter()
+end, function()
+  f18:exit()
+end)
+
+-- Meh (F18/Caps Lock) key bindings for window management
+-- These provide quick access to common window operations
+
+-- Helper function to get focused window
+local function W()
+  return hs.window.focusedWindow()
+end
+
+-- Window positioning: thirds (U/I/O)
+f18:bind({}, 'u', function()
+  local w = W()
+  if w then
+    w:moveToUnit({ x = 0, y = 0, w = 1 / 3, h = 1 }, 0)
+  end
+end)
+f18:bind({}, 'i', function()
+  local w = W()
+  if w then
+    w:moveToUnit({ x = 1 / 3, y = 0, w = 1 / 3, h = 1 }, 0)
+  end
+end)
+f18:bind({}, 'o', function()
+  local w = W()
+  if w then
+    w:moveToUnit({ x = 2 / 3, y = 0, w = 1 / 3, h = 1 }, 0)
+  end
+end)
+
+-- Window positioning: half width, full height (Y)
+f18:bind({}, 'y', function()
+  local w = W()
+  if w then
+    w:moveToUnit({ x = 0, y = 0, w = 0.5, h = 1 }, 0)
+  end
+end)
+
+-- Cycle through all windows (H/L)
+-- We need to maintain state to properly cycle through all windows
+local windowCycleIndex = 1
+local windowCycleList = {}
+local lastCycleTime = 0
+
+local function getWindowCycleList()
+  local currentTime = hs.timer.secondsSinceEpoch()
+  -- Reset if more than 2 seconds have passed since last cycle
+  if currentTime - lastCycleTime > 2 then
+    windowCycleIndex = 1
+    windowCycleList = hs.window.orderedWindows()
+  end
+  lastCycleTime = currentTime
+  return windowCycleList
+end
+
+f18:bind({}, 'h', function()
+  local windows = getWindowCycleList()
+  if #windows <= 1 then
+    return
+  end
+
+  -- Cycle backward
+  windowCycleIndex = windowCycleIndex - 1
+  if windowCycleIndex < 1 then
+    windowCycleIndex = #windows
+  end
+
+  windows[windowCycleIndex]:focus()
+end)
+
+f18:bind({}, 'l', function()
+  local windows = getWindowCycleList()
+  if #windows <= 1 then
+    return
+  end
+
+  -- Cycle forward
+  windowCycleIndex = windowCycleIndex + 1
+  if windowCycleIndex > #windows then
+    windowCycleIndex = 1
+  end
+
+  windows[windowCycleIndex]:focus()
+end)
+
+-- Window sizing: maximize (Up/J) and center (Down)
+f18:bind({}, 'up', function()
+  local w = W()
+  if w then
+    w:maximize(0)
+  end
+end)
+f18:bind({}, 'j', function()
+  local w = W()
+  if w then
+    w:maximize(0)
+  end
+end)
+f18:bind({}, 'down', function()
+  local w = W()
+  if not w then
+    return
+  end
+  local f = w:frame()
+  local sf = w:screen():frame()
+  if f.w < sf.w * 0.95 then
+    w:maximize(0)
+  else
+    local ww, hh = math.floor(sf.w * 0.5), math.floor(sf.h * 0.9)
+    local xx = sf.x + math.floor((sf.w - ww) / 2)
+    local yy = sf.y + math.floor((sf.h - hh) / 2)
+    w:setFrame({ x = xx, y = yy, w = ww, h = hh }, 0)
+  end
+end)
+f18:bind({}, 'k', function()
+  local w = W()
+  if w then
+    local sf = w:screen():frame()
+    local ww, hh = math.floor(sf.w * 0.9), math.floor(sf.h * 0.9)
+    local xx = sf.x + math.floor((sf.w - ww) / 2)
+    local yy = sf.y + math.floor((sf.h - hh) / 2)
+    w:setFrame({ x = xx, y = yy, w = ww, h = hh }, 0)
+  end
+end)
+
+-- Move to next/previous screen (. and ,)
+f18:bind({}, '.', function()
+  local w = W()
+  if w then
+    local s = w:screen()
+    local ns = s:toEast() or s:toWest()
+    if ns then
+      w:moveToScreen(ns, true, true, 0)
+    end
+  end
+end)
+f18:bind({}, ',', function()
+  local w = W()
+  if w then
+    local s = w:screen()
+    local ps = s:toWest() or s:toEast()
+    if ps then
+      w:moveToScreen(ps, true, true, 0)
+    end
+  end
+end)
+
+-- Window positioning: halves (Left/Right arrows)
+f18:bind({}, 'left', function()
+  local w = W()
+  if w then
+    w:moveToUnit(hs.layout.left50, 0)
+  end
+end)
+f18:bind({}, 'right', function()
+  local w = W()
+  if w then
+    w:moveToUnit(hs.layout.right50, 0)
+  end
+end)
+
+-- Paste from clipboard with Meh + V
+f18:bind({}, 'v', function()
+  hs.eventtap.keyStrokes(hs.pasteboard.getContents())
+end)
+
+-- Paste 1Password secret with Meh + P
+f18:bind({}, 'p', function()
+  local output, status =
+    hs.execute('op read "op://Svea/3hzhctmvovbwlgulv7mgy25rf4/login-input"', true)
+  if status then
+    hs.eventtap.keyStrokes(output:gsub('%s+$', '')) -- trim trailing whitespace
+  else
+    hs.alert.show '1Password CLI error'
+  end
+end)
+
+-- require 'generate_emmylua'

base/huskyrc

@@ -1,4 +0,0 @@
-#!/bin/env bash
-
-[ -z "$NVM_DIR" ] && export NVM_DIR="$HOME/.config/nvm"
-[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

base/plan

@@ -12,5 +12,3 @@
                    ~-.__|      /_ - ~ ^|      /- _      `..-'   f: f:
                         |     /        |     /     ~-.     `-. _||_||_
                         |_____|        |_____|         ~ - . _ _ _ _ _>
-
-

base/shellcheckrc

@@ -4,4 +4,3 @@
 # paths in source statements (since 0.8.0).
 external-sources=true
 includeAllWorkspaceSymbols=true
-

base/zshrc

@@ -7,18 +7,13 @@
 autoload -U promptinit; promptinit
 
 export DOTFILES="$HOME/.dotfiles"
-LOCAL_SHARE="$HOME/.local/share"
-export PATH="$HOME/.local/bin:$DOTFILES/local/bin:$LOCAL_SHARE/nvim/mason/bin:$LOCAL_SHARE/bob/nvim-bin:$LOCAL_SHARE/cargo/bin:/opt/homebrew/bin:/usr/local/bin:$PATH"
+# Minimal PATH for x-have and utilities; full PATH set in shared.sh/exports
+export PATH="$HOME/.local/bin:$DOTFILES/local/bin:$PATH"
 export SHARED_SCRIPTS_SOURCED=0
 
 source "$DOTFILES/config/shared.sh"
 
-# zsh completions directory
-[ -z "$ZSH_COMPLETIONS" ] && export ZSH_COMPLETIONS="$XDG_CONFIG_HOME/zsh/completion"
-
-# Add zsh completions to FPATH, compinit will be called later
-FPATH="$ZSH_COMPLETIONS:$FPATH"
-
+# zsh completions directory (ZSH_CUSTOM_COMPLETION_PATH set in shared.sh)
 ZSH_COMPDUMP="$XDG_CACHE_HOME/zsh/zcompdump-${SHORT_HOST}-${ZSH_VERSION}"
 
 source "$DOTFILES/config/zsh/antidote.zsh"
@@ -33,33 +28,13 @@ source_fzf_config()
   fi
 }
 
-# Function to set up tmux window name plugin if tmux is active
-setup_tmux_window_name_plugin()
-{
-  if [[ -n "$TMUX" ]]; then
-    local tmux_window_name_plugin="$TMUX_PLUGINS/tmux-window-name/scripts/rename_session_windows.py"
-    if [[ -f "$tmux_window_name_plugin" ]]; then
-      tmux_window_name()
-      {
-        ($tmux_window_name_plugin &)
-      }
-      add-zsh-hook chpwd tmux_window_name
-      tmux_window_name
-    fi
-  fi
-}
-
 source_fzf_config
-setup_tmux_window_name_plugin
 x-have antidot && eval "$(antidot init)"
 
 autoload -Uz compinit bashcompinit
-compinit -d $ZSH_COMPDUMP
+compinit -d "$ZSH_COMPDUMP"
 bashcompinit
 
 # To customize prompt, run `p10k configure` or edit ~/.p10k.zsh.
 export P10K_CONFIG="$DOTFILES/config/zsh/p10k.zsh"
 [[ ! -f "$P10K_CONFIG" ]] || source "$P10K_CONFIG"
-
-# Added by LM Studio CLI (lms)
-export PATH="$PATH:$HOME/.lmstudio/bin"

biome.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.7/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true,
+    "defaultBranch": "main"
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": [
+      "**",
+      "!!**/.mypy_cache",
+      "!!**/Brewfile.lock.json",
+      "!!**/base/plan",
+      "!!**/config/cheat/cheatsheets/community",
+      "!!**/config/cheat/cheatsheets/tldr",
+      "!!**/config/fzf",
+      "!!**/config/nvim",
+      "!!**/config/op/plugins/used_plugins",
+      "!!**/config/tmux/plugins",
+      "!!**/config/zsh",
+      "!!**/config/karabiner",
+      "!!**/config/vim",
+      "!!**/lazy-lock.json",
+      "!!**/local/bin/antigen.zsh",
+      "!!**/local/bin/asdf",
+      "!!**/tools/antidote",
+      "!!**/tools/dotbot",
+      "!!**/node_modules"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 80
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedVariables": "warn",
+        "noUnusedImports": "warn"
+      },
+      "style": {
+        "useConst": "warn",
+        "useTemplate": "warn"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn",
+        "noConsole": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "enabled": true,
+      "quoteStyle": "single",
+      "jsxQuoteStyle": "double",
+      "trailingCommas": "all",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false,
+      "quoteProperties": "asNeeded",
+      "indentStyle": "space",
+      "indentWidth": 2
+    }
+  },
+  "json": {
+    "parser": {
+      "allowComments": true,
+      "allowTrailingCommas": false
+    },
+    "formatter": {
+      "enabled": true,
+      "indentStyle": "space",
+      "indentWidth": 2,
+      "lineWidth": 80
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["*.md", "*.mdx"],
+      "formatter": {
+        "enabled": true,
+        "lineWidth": 120
+      }
+    },
+    {
+      "includes": ["package.json"],
+      "json": {
+        "formatter": {
+          "enabled": true,
+          "indentWidth": 2
+        }
+      }
+    }
+  ]
+}

config/aerospace/aerospace.toml

@@ -1,251 +0,0 @@
-# Start AeroSpace at login
-start-at-login = false
-
-# Normalizations. See: https://nikitabobko.github.io/AeroSpace/guide#normalization
-enable-normalization-flatten-containers = true
-enable-normalization-opposite-orientation-for-nested-containers = true
-
-# See: https://nikitabobko.github.io/AeroSpace/guide#layouts
-# The 'accordion-padding' specifies the size of accordion padding
-# You can set 0 to disable the padding feature
-accordion-padding = 10
-
-# Possible values: tiles|accordion
-default-root-container-layout = 'tiles'
-
-# Possible values: horizontal|vertical|auto
-# 'auto' means: wide monitor (anything wider than high) gets horizontal orientation,
-#               tall monitor (anything higher than wide) gets vertical orientation
-default-root-container-orientation = 'auto'
-
-# Mouse follows focus when focused monitor changes
-# Drop it from your config, if you don't like this behavior
-# See https://nikitabobko.github.io/AeroSpace/guide#on-focus-changed-callbacks
-# See https://nikitabobko.github.io/AeroSpace/commands#move-mouse
-# Fallback value (if you omit the key): on-focused-monitor-changed = []
-on-focused-monitor-changed = ['move-mouse monitor-lazy-center']
-
-# You can effectively turn off macOS "Hide application" (cmd-h) feature by toggling this flag
-# Useful if you don't use this macOS feature, but accidentally hit cmd-h or cmd-alt-h key
-# Also see: https://nikitabobko.github.io/AeroSpace/goodness#disable-hide-app
-automatically-unhide-macos-hidden-apps = true
-
-# [[on-window-detected]]
-# if.app-id = 'com.apple.systempreferences'
-# if.app-name-regex-substring = 'settings'
-# if.window-title-regex-substring = 'substring'
-# if.workspace = 'workspace-name'
-# if.during-aerospace-startup = true
-# check-further-callbacks = true
-# run = ['layout floating', 'move-node-to-workspace S']  # The callback itself
-
-[[on-window-detected]]
-if.app-name-regex-substring = 'settings' # All settings
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.apple.systempreferences' # macOS System Preferences
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.1password.1password' # 1Password
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'org.ferdium.ferdium-app' # Ferdium, has WhatsApp etc.
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.jetbrains.PhpStorm' # PhpStorm
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.apple.finder' # Finder
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.apple.Preview' # Preview
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.apple.mail' # Mail
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.DanPristupov.Fork' # Fork
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.flexibits.fantastical2.mac' # Fantastical
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'org.whispersystems.signal-desktop' # Signal
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.tidal.desktop' # TIDAL
-run = ['layout floating', 'move-node-to-workspace 2'] # Float and move to workspace 2
-
-[[on-window-detected]]
-if.app-id = 'com.apple.TV' # Apple TV app
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.setapp.DesktopClient' # Setapp
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.electron.dockerdesktop' # Docker Desktop
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.tinyspeck.slackmacgap' # Slack
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'md.obsidia' # Obsidian
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.todoist.mac.Todoist' # Todoist
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.apple.backup.launcher' # TimeMachine
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.philipyoungg.session-setapp' # Session app (Setapp)
-run = ['layout floating']
-
-[[on-window-detected]]
-if.app-id = 'com.microsoft.rdc.macos' # Remote Desktop
-run = ['layout floating']
-
-# Possible values: (qwerty|dvorak)
-# See https://nikitabobko.github.io/AeroSpace/guide#key-mapping
-[key-mapping]
-preset = 'qwerty'
-
-# Gaps between windows (inner-*) and between monitor edges (outer-*).
-# Possible values:
-# - Constant:     gaps.outer.top = 8
-# - Per monitor:  gaps.outer.top = [{ monitor.main = 16 }, { monitor."some-pattern" = 32 }, 24]
-#                 In this example, 24 is a default value when there is no match.
-#                 Monitor pattern is the same as for 'workspace-to-monitor-force-assignment'.
-#                 See: https://nikitabobko.github.io/AeroSpace/guide#assign-workspaces-to-monitors
-[gaps]
-inner.horizontal = 5
-inner.vertical =   5
-outer.top = [{ monitor.'^built-in retina display$' = 0 }, 0]
-outer.right =      0
-outer.bottom =     0
-outer.left =       0
-
-# 'main' binding mode declaration
-# See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes
-# 'main' binding mode must be always presented
-# Fallback value (if you omit the key): mode.main.binding = {}
-[mode.main.binding]
-
-cmd-h = [] # Disable "hide application"
-cmd-alt-h = [] # Disable "hide others"
-
-# All possible keys:
-# - Letters.        a, b, c, ..., z
-# - Numbers.        0, 1, 2, ..., 9
-# - Keypad numbers. keypad0, keypad1, keypad2, ..., keypad9
-# - F-keys.         f1, f2, ..., f20
-# - Special keys.   minus, equal, period, comma, slash, backslash, quote, semicolon, backtick,
-#                   leftSquareBracket, rightSquareBracket, space, enter, esc, backspace, tab
-# - Keypad special. keypadClear, keypadDecimalMark, keypadDivide, keypadEnter, keypadEqual,
-#                   keypadMinus, keypadMultiply, keypadPlus
-# - Arrows.         left, down, up, right
-
-# All possible modifiers: cmd, alt, ctrl, shift
-
-# All possible commands: https://nikitabobko.github.io/AeroSpace/commands
-
-# See: https://nikitabobko.github.io/AeroSpace/commands#exec-and-forget
-# You can uncomment the following lines to open up terminal with alt + enter shortcut (like in i3)
-# alt-enter = '''exec-and-forget osascript -e '
-# tell application "Terminal"
-#     do script
-#     activate
-# end tell'
-# '''
-
-# alt-cmd-shift-f = 'fullscreen'
-# alt-shift-f = 'layout floating'
-# alt-shift-tab = 'move-workspace-to-monitor --wrap-around next'
-
-# See: https://nikitabobko.github.io/AeroSpace/commands#focus
-alt-h = 'focus left'
-alt-j = 'focus down'
-alt-k = 'focus up'
-alt-l = 'focus right'
-
-# See: https://nikitabobko.github.io/AeroSpace/commands#workspace
-alt-shift-1 = 'workspace 1' # Main
-alt-shift-2 = 'workspace 2' # Media
-ctrl-shift-1 = 'move-node-to-workspace 1' # Move node to Main
-ctrl-shift-2 = 'move-node-to-workspace 2' # Move node to Media
-
-alt-shift-tab = 'workspace-back-and-forth' # Switch between workspaces
-ctrl-shift-tab = 'move-workspace-to-monitor --wrap-around prev'
-
-# See: https://nikitabobko.github.io/AeroSpace/commands#mode
-# See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes
-alt-a = 'mode apps'
-alt-s = 'mode service'
-alt-m = 'mode move'
-
-# ╭──────────────────────────────────────────────────────────╮
-# │                          alt-m                           │
-# ╰──────────────────────────────────────────────────────────╯
-[mode.move.binding]
-esc = ['reload-config', 'mode main']
-# See: https://nikitabobko.github.io/AeroSpace/commands#move-node-to-workspace
-1 = ['move-node-to-workspace 1 --focus-follows-window']
-2 = ['move-node-to-workspace 2 --focus-follows-window']
-# See: https://nikitabobko.github.io/AeroSpace/commands#move
-h = 'move left'
-j = 'move down'
-k = 'move up'
-l = 'move right'
-# See: https://nikitabobko.github.io/AeroSpace/commands#join-with
-shift-h = 'join-with left'
-shift-j = 'join-with down'
-shift-k = 'join-with up'
-shift-l = 'join-with right'
-# https://nikitabobko.github.io/AeroSpace/commands#resize
-ctrl-h = 'resize smart -70'
-ctrl-l = 'resize smart +70'
-shift-left = 'resize smart +70'
-shift-right = 'resize smart -70'
-# https://nikitabobko.github.io/AeroSpace/commands#flatten-workspace-tree
-r = ['flatten-workspace-tree', 'mode main'] # reset layout
-
-# ╭──────────────────────────────────────────────────────────╮
-# │                          alt-a                           │
-# ╰──────────────────────────────────────────────────────────╯
-[mode.apps.binding]
-esc = ['reload-config', 'mode main']
-b = ['exec-and-forget open -a /Applications/Brave Browser.app', 'mode main'] # Browser
-c = ['exec-and-forget open -a /Applications/Ferdium.app', 'mode main'] # Chat
-g = ['exec-and-forget open -a /Applications/Ghostty.app', 'mode main'] # Ghostty
-o = ['exec-and-forget open -a /Applications/Obsidian.app', 'mode main'] # Obsidian
-s = ['exec-and-forget open -a /Applications/Slack.app', 'mode main'] # Slack
-t = ['exec-and-forget open -a /Applications/TIDAL.app', 'mode main'] # Tidal
-w = ['exec-and-forget open -a /Applications/WezTerm.app', 'mode main'] # WezTerm
-
-# ╭──────────────────────────────────────────────────────────╮
-# │                          alt-s                           │
-# ╰──────────────────────────────────────────────────────────╯
-[mode.service.binding]
-esc = ['reload-config', 'mode main'] # reload config
-r = ['flatten-workspace-tree', 'mode main'] # reset layout
-# See: https://nikitabobko.github.io/AeroSpace/commands#layout
-f = ['layout floating tiling', 'mode main'] # Toggle between floating and tiling layout
-backspace = ['close-all-windows-but-current', 'mode main']

config/alacritty/alacritty.toml

@@ -1,8 +1,3 @@
-import = [
-  # Default to night if the copied one doesn't exist.
-  "~/.dotfiles/config/alacritty/theme-night.toml",
-  "~/.config/alacritty/theme-active.toml"
-]
 
 [env]
 TERM = "xterm-256color"
@@ -50,3 +45,10 @@ lines = 75
 [window.padding]
 x = 5
 y = 5
+
+[general]
+import = [
+  # Default to night if the copied one doesn't exist.
+  "~/.dotfiles/config/alacritty/theme-night.toml",
+  "~/.config/alacritty/theme-active.toml"
+]

config/alias

@@ -7,8 +7,6 @@ x-have eza && {
   alias ls="eza -h -s=type --git --icons --group-directories-first"
 }
 
-alias vim='vim -u "$XDG_CONFIG_HOME/vim/vimrc"'
-
 # Easier navigation: .., ..., ....
 alias ..="cd .."
 alias ...="cd ../.."
@@ -35,6 +33,8 @@ alias .c='cd $HOME/Code'
 alias .d='cd $DOTFILES'
 alias .l='cd $HOME/.local'
 alias .o='cd $HOME/Code/ivuorinen/obsidian/'
+alias .s='cd $HOME/Code/s'
+alias .p='cd $HOME/Code/ivuorinen'
 
 # Shortcuts for listing
 alias ll="ls -la"

config/amethyst/amethyst.yml

@@ -93,13 +93,13 @@ expand-main:
 # Note that not all layouts respond to this command.
 increase-main:
   mod: mod1
-  key: ','
+  key: ","
 
 # Decrease the number of windows in the main pane.
 # Note that not all layouts respond to this command.
 decrease-main:
   mod: mod1
-  key: '.'
+  key: "."
 
 # General purpose command for custom layouts.
 # Functionality is layout-dependent.
@@ -180,7 +180,7 @@ swap-main:
 # Move focus to the n-th screen in the list; e.g.,
 # focus-screen-3 will move mouse focus to the 3rd screen.
 # Note that the main window in the given screen will be focused.
-#focus-screen-n:
+# focus-screen-n:
 # focus-screen-<screen-number>:
 #   mod: mod1
 #   key: y
@@ -197,12 +197,12 @@ swap-main:
 #   key: i
 
 # Select tall layout
-#select-tall-layout:
-# mod: mod1
-# key: a
+# select-tall-layout:
+#  mod: mod1
+#  key: a
 
 # Select wide layout
-#select-wide-layout:
+# select-wide-layout:
 #  mod: mod1
 #  key: s
 

config/amethyst/layouts/almost-maximize.js

@@ -6,21 +6,19 @@
  *
  * @param {Object} windows - All windows in the current space.
  * @param {Object} screenFrame - The frame of the current screen.
- * @param {Object} state - The state of the current space.
- * @param {Object} extendedFrames - The frames of the windows in the current space.
  * @return {Object} - The frames for the windows in the current space.
  */
 function layout() {
   return {
     name: 'Almost Maximize',
-    getFrameAssignments: (windows, screenFrame, state, extendedFrames) => {
+    getFrameAssignments: (windows, screenFrame) => {
       const width = screenFrame.width * 0.95
       const height = screenFrame.height * 0.95
       const x = (screenFrame.width - width) / 2
       const y = (screenFrame.height - height) / 2
       const windowFrames = {}
 
-      windows.forEach(window => {
+      windows.forEach((window) => {
         windowFrames[window.id] = {
           Y: screenFrame.y + y,
           x: screenFrame.x + x,
@@ -33,3 +31,5 @@ function layout() {
     },
   }
 }
+
+module.exports = layout()

config/aqua/aqua.yaml

@@ -1,15 +0,0 @@
----
-# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/aqua-yaml.json
-# aqua - Declarative CLI Version Manager
-# https://aquaproj.github.io/
-# checksum:
-#   enabled: true
-#   require_checksum: true
-#   supported_envs:
-#   - all
-registries:
-  - type: standard
-    ref: v4.346.0 # renovate: depName=aquaproj/aqua-registry
-packages:
-  - name: cli/cli
-    version: 'v2.69.0'

config/asdf/asdfrc

@@ -1,5 +0,0 @@
-# See the docs for explanations: https://asdf-vm.com/manage/configuration.html
-
-legacy_version_file=yes
-use_release_candidates=no
-concurrency=auto

config/asdf/cargo-packages

@@ -1,25 +0,0 @@
-// A cargo subcommand for checking and applying
-// updates to installed executables
-cargo-update
-// Cargo cache management utility
-cargo-cache
-// An incremental parsing system for programming tools
-tree-sitter-cli
-// a subprocess caching utility
-bkt
-// a structural diff that understands syntax
-difftastic
-// A simple, fast and user-friendly alternative to 'find'
-fd-find
-// recursively searches directories for a
-// regex pattern while respecting your gitignore
-ripgrep
-// A version manager for neovim
-bob-nvim
-// bottom, btm - A cross-platform graphical process/system monitor with
-// a customizable interface and a multitude of features.
-bottom
-// A modern alternative to ls
-eza
-// Tmux Sessionizer: A tool for opening git repositories as tmux sessions
-tmux-sessionizer

config/asdf/gem-packages

@@ -1 +0,0 @@
-bundler

config/asdf/golang-packages

@@ -1,23 +0,0 @@
-// These are golang packages I use,
-// so they should be available with all versions
-
-// Aqua is a package manager like asdf, or Brew
-github.com/aquaproj/aqua/v2/cmd/aqua@latest
-// Git Profile allows you to switch between user profiles in git repos
-github.com/dotzero/git-profile@v1.4.0
-// An extensible command line tool or library to format yaml files.
-github.com/google/yamlfmt/cmd/yamlfmt@v0.13.0
-// Parsing HTML at the command line
-github.com/ericchiang/pup@v0.4.0
-// HTML to Markdown converter
-github.com/suntong/html2md@v1.5.0
-// cheat allows you to create and view interactive cheatsheets on the cli.
-github.com/cheat/cheat/cmd/cheat@4.4.2
-// Render markdown on the CLI, with pizzazz! 💅
-github.com/charmbracelet/glow@v1.5.1
-// Static checker for GitHub Actions workflow files
-github.com/rhysd/actionlint/cmd/actionlint@v1.7.1
-// Cleans up your $HOME from those pesky dotfiles
-github.com/doron-cohen/antidot@v0.6.3
-// FZF is a general-purpose command-line fuzzy finder.
-github.com/junegunn/fzf@latest

config/asdf/npm-packages

@@ -1,7 +0,0 @@
-blade-formatter
-corepack
-editorconfig-checker
-github-release-notes
-neovim
-npm
-stylelint-lsp

config/asdf/plugin-versions

@@ -1,20 +0,0 @@
-1password-cli         https://github.com/NeoHsu/asdf-1password-cli.git            f5d5aab
-age                   https://github.com/threkk/asdf-age.git                      396bdf6
-asdf-plugin-manager   https://github.com/asdf-community/asdf-plugin-manager.git   b5862c1
-direnv                https://github.com/asdf-community/asdf-direnv.git           6ff3dbe
-dotenv-linter         https://github.com/wesleimp/asdf-dotenv-linter.git          1369f53
-editorconfig-checker  https://github.com/gabitchov/asdf-editorconfig-checker.git  585c1d5
-fd                    https://gitlab.com/wt0f/asdf-fd.git                         17d56e0
-github-cli            https://github.com/bartlomiejdanek/asdf-github-cli.git      e0605b7
-golang                https://github.com/asdf-community/asdf-golang.git           e2527a3
-hadolint              https://github.com/devlincashman/asdf-hadolint.git          c8eb88b
-kubectl               https://github.com/asdf-community/asdf-kubectl.git          2fb3b57
-pre-commit            https://github.com/jonathanmorley/asdf-pre-commit.git       26bfc42
-ripgrep               https://gitlab.com/wt0f/asdf-ripgrep.git                    e836665
-rust                  https://github.com/code-lever/asdf-rust.git                 95acf4f
-shellcheck            https://github.com/luizm/asdf-shellcheck.git                66200ff
-shfmt                 https://github.com/luizm/asdf-shfmt.git                     a42c5ff
-terragrunt            https://github.com/ohmer/asdf-terragrunt.git                29f2935
-tf-summarize          https://github.com/adamcrews/asdf-tf-summarize.git          880ad26
-yamllint              https://github.com/ericcornelissen/asdf-yamllint.git        e4cfb17
-yq                    https://github.com/sudermanjr/asdf-yq.git                   772992f

config/asdf/python-packages

@@ -1,4 +0,0 @@
-ansible
-pipenv
-neovim
-libtmux

config/cheat/cheatsheets/personal/printf

@@ -69,5 +69,3 @@ Available format modifiers are:
 '.          For decimal conversions, applies the thousands grouping
             separator to the integer portion of the output according
             to the current LC_NUMERIC file.
-
-

config/dircolors

@@ -56,11 +56,11 @@ TERM xterm*
 RESET 0 # reset to "normal" color
 DIR 01;34 # directory
 LINK 01;36 # symbolic link. (If you set this to 'target' instead of a
- # numerical value, the color is as for the file pointed to.)
-MULTIHARDLINK 00 # regular file with more than one link
-FIFO 40;33 # pipe
-SOCK 01;35 # socket
-DOOR 01;35 # door
+# numerical value, the color is as for the file pointed to.)
+MULTIHARDLINK 00  # regular file with more than one link
+FIFO 40;33  # pipe
+SOCK 01;35  # socket
+DOOR 01;35  # door
 BLK 40;33;01 # block device driver
 CHR 40;33;01 # character device driver
 ORPHAN 40;31;01 # symlink to nonexistent file, or non-stat'able file ...

config/direnv/direnv.toml

@@ -1,13 +0,0 @@
-[global]
-disable_stdin = false
-load_dotenv = true
-hide_env_diff = false
-
-[whitelist]
-prefix = [
-  "~/Code/"
-]
-exact = [
-  "~/.dotfiles/.envrc"
-]
-

config/direnv/lib/use_asdf.sh

@@ -1,4 +0,0 @@
-### Do not edit. This was autogenerated by 'asdf direnv setup' ###
-use_asdf() {
-  source_env "$(asdf direnv envrc "$@")"
-}

config/exports

@@ -4,17 +4,30 @@
 
 # Set XDG directories if not already set
 # https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
-[ -z "$XDG_CONFIG_HOME" ] && export XDG_CONFIG_HOME="$HOME/.config"
-[ -z "$XDG_DATA_HOME" ] && export XDG_DATA_HOME="$HOME/.local/share"
-[ -z "$XDG_CACHE_HOME" ] && export XDG_CACHE_HOME="$HOME/.cache"
-[ -z "$XDG_STATE_HOME" ] && export XDG_STATE_HOME="$HOME/.local/state"
-[ -z "$XDG_BIN_HOME" ] && export XDG_BIN_HOME="$HOME/.local/bin"
-[ -z "$XDG_RUNTIME_DIR" ] && export XDG_RUNTIME_DIR="$HOME/.local/run"
+[ -z "${XDG_CONFIG_HOME:-}" ] && export XDG_CONFIG_HOME="$HOME/.config"
+[ -z "${XDG_DATA_HOME:-}" ] && export XDG_DATA_HOME="$HOME/.local/share"
+[ -z "${XDG_CACHE_HOME:-}" ] && export XDG_CACHE_HOME="$HOME/.cache"
+[ -z "${XDG_STATE_HOME:-}" ] && export XDG_STATE_HOME="$HOME/.local/state"
+[ -z "${XDG_BIN_HOME:-}" ] && export XDG_BIN_HOME="$HOME/.local/bin"
+[ -z "${XDG_RUNTIME_DIR:-}" ] && export XDG_RUNTIME_DIR="$HOME/.local/run"
 
 # if DOTFILES is not set, set it to the default location
-[ -z "$DOTFILES" ] && export DOTFILES="$HOME/.dotfiles"
+[ -z "${DOTFILES:-}" ] && export DOTFILES="$HOME/.dotfiles"
 
-export PATH="$XDG_BIN_HOME:$DOTFILES/local/bin:$XDG_DATA_HOME/bob/nvim-bin:$XDG_DATA_HOME/cargo/bin:/opt/homebrew/bin:/usr/local/bin:$PATH"
+# Editor settings
+[ -z "${EDITOR:-}" ] && export EDITOR="nvim"
+[ -z "${VISUAL:-}" ] && export VISUAL="code"
+
+# Bootstrap: ensure local/bin is on PATH so x-path is available
+PATH="$DOTFILES/local/bin:$PATH"
+# Use x-path to deduplicate PATH entries (only if x-path is available)
+if command -v x-path &> /dev/null; then
+  # shellcheck source=../local/bin/x-path
+  source "$(command -v x-path)"
+  normalize_path_var
+  do_prepend "$XDG_BIN_HOME" "$DOTFILES/local/bin" "/opt/homebrew/bin" "/usr/local/bin"
+fi
+export PATH
 
 if ! command -v msg &> /dev/null; then
   # Function to print messages if VERBOSE is enabled
@@ -150,6 +163,7 @@ commit()
   git commit -a -m "$commitMessage"
 }
 
+# Run Laravel scheduler in a loop
 scheduler()
 {
   while :; do
@@ -282,7 +296,8 @@ export LESSHISTFILE="$XDG_STATE_HOME"/less/history
 export MANPAGER="less -X"
 
 # Always enable colored `grep` output
-export GREP_OPTIONS="--color=auto"
+# Note: GREP_OPTIONS is deprecated since GNU grep 2.21
+# Color is handled via alias in config/alias
 
 # check the window size after each command and, if necessary,
 # update the values of LINES and COLUMNS.
@@ -302,7 +317,7 @@ export ANTIDOTE_PLUGINS="$XDG_CONFIG_HOME/zsh/antidote_plugins"
 # https://docs.ansible.com/ansible/latest/reference_appendices/config.html
 msg "Setting up Ansible configuration"
 export ANSIBLE_HOME="$XDG_CONFIG_HOME/ansible"
-export ANSIBLE_CONFIG="$XDG_CONFIG_HOME/ansible.cfg"
+export ANSIBLE_CONFIG="$ANSIBLE_HOME/ansible.cfg"
 export ANSIBLE_GALAXY_CACHE_DIR="$XDG_CACHE_HOME/ansible/galaxy_cache"
 x-dc "$ANSIBLE_HOME"
 x-dc "$ANSIBLE_GALAXY_CACHE_DIR"
@@ -323,10 +338,25 @@ export AWS_CONFIGURE_OUTPUT=true
 export AWS_CONFIGURE_PROFILE=true
 export AWS_CONFIGURE_PROMPT=true
 export AWS_CONFIGURE_PROMPT_DEFAULT="default"
+export AWS_SESSION_TOKEN_FILE="${XDG_STATE_HOME}/aws/session_token"
+export AWS_CONFIGURE_SESSION=true
+export AWS_CONFIGURE_SESSION_DURATION=7200
+export AWS_CONFIGURE_SESSION_MFA=true
 
-# bob manages nvim versions
-msg "Setting up bob configuration"
-x-path-prepend "$XDG_DATA_HOME/bob/nvim-bin"
+# Mason (nvim package manager)
+msg "Setting up Mason configuration"
+export MASON_HOME="$XDG_DATA_HOME/nvim/mason"
+
+# Neovim environment variables
+msg "Setting up Neovim configuration"
+[ -z "${NVIM_STATE:-}" ] && export NVIM_STATE="$XDG_STATE_HOME/nvim"
+[ -z "${NVIM_CONFIG_HOME:-}" ] && export NVIM_CONFIG_HOME="$XDG_CONFIG_HOME/nvim"
+[ -z "${NVIM_DATA_HOME:-}" ] && export NVIM_DATA_HOME="$XDG_DATA_HOME/nvim"
+[ -z "${NVIM_CACHE_HOME:-}" ] && export NVIM_CACHE_HOME="$XDG_CACHE_HOME/nvim"
+[ -z "${NVIM_LOG_PATH:-}" ] && export NVIM_LOG_PATH="$NVIM_STATE/log"
+[ -z "${NVIM_SESSION_PATH:-}" ] && export NVIM_SESSION_PATH="$NVIM_STATE/session"
+[ -z "${NVIM_SHADA_PATH:-}" ] && export NVIM_SHADA_PATH="$NVIM_STATE/shada"
+[ -z "${NVIM_UNDO_PATH:-}" ] && export NVIM_UNDO_PATH="$NVIM_STATE/undo"
 
 # bkt (shell command caching tool) configuration
 msg "Setting up bkt configuration"
@@ -348,11 +378,9 @@ export COMPOSER_HOME="$XDG_STATE_HOME/composer"
 export COMPOSER_BIN="$COMPOSER_HOME/vendor/bin"
 export PATH="$COMPOSER_BIN:$PATH"
 
-# direnv, https://direnv.net/
-# https://direnv.net/docs/hook.html
-# Set the hook to show the direnv message in a different color
-# export DIRENV_LOG_FORMAT=$'\033[2mdirenv: %s\033[0m'
-export DIRENV_LOG_FORMAT=
+# Yarn
+msg "Setting up Yarn configuration"
+export YARN_GLOBAL_FOLDER="$XDG_DATA_HOME/yarn"
 
 # docker, https://docs.docker.com/engine/reference/commandline/cli/
 msg "Setting up Docker configuration"
@@ -360,6 +388,11 @@ export DOCKER_CONFIG="${XDG_CONFIG_HOME}/docker"
 x-dc "$DOCKER_CONFIG"
 # Docker: Disable snyk ad
 export DOCKER_SCAN_SUGGEST=false
+export DOCKER_HIDE_LEGACY_COMMANDS=true
+
+# direnv
+msg "Setting up direnv configuration"
+export DIRENV_LOG_FORMAT=""
 
 # fzf
 export FZF_BASE="${XDG_CONFIG_HOME}/fzf"
@@ -379,13 +412,6 @@ export GOBIN="$XDG_BIN_HOME"
 # Lando
 export PATH="$HOME/.lando/bin${PATH+:$PATH}" #landopath
 
-# NPM: Add npm packages to path
-msg "Setting up NPM configuration"
-x-have node && {
-  NVM_NODE_BIN_DIR="$(dirname "$(which node)")"
-  export PATH="$NVM_NODE_BIN_DIR:$PATH"
-}
-
 # oh-my-posh (omp) configuration
 msg "Setting up oh-my-posh configuration"
 export OHMYPOSH_CFG="$DOTFILES/config/omp/own.toml"
@@ -395,25 +421,21 @@ msg "Setting up 1Password CLI configuration"
 export OP_CACHE="$XDG_STATE_HOME/1password"
 
 # Python
-#
-# pyenv, python environments
 msg "Setting up Python configuration"
 export WORKON_HOME="$XDG_DATA_HOME/virtualenvs"
-export PYENV_ROOT="$XDG_STATE_HOME/pyenv"
 ## for MichaelAquilina/zsh-autoswitch-virtualenv
 export AUTOSWITCH_VIRTUAL_ENV_DIR="$WORKON_HOME"
-export PATH="$PYENV_ROOT/bin:$PYENV_ROOT/shims:$PATH"
-[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
-x-have pyenv && eval "$(pyenv init -)"
 
 # Rust / cargo
 msg "Setting up Rust/Cargo configuration"
-export RUST_WITHOUT=rust-docs
+export CARGO_HOME="$XDG_DATA_HOME/cargo"
+export CARGO_BIN_HOME="$XDG_BIN_HOME"
+export RUSTUP_HOME="$XDG_DATA_HOME/rustup"
+export RUST_WITHOUT="clippy,docs,rls"
 
-# screen
-# https://www.gnu.org/software/screen/manual/screen.html
-msg "Setting up screen configuration"
-export SCREENRC="$XDG_CONFIG_HOME/misc/screenrc"
+# Poetry
+msg "Setting up Poetry configuration"
+export POETRY_HOME="$XDG_DATA_HOME/poetry"
 
 # sonarlint
 # https://www.sonarlint.org/
@@ -442,21 +464,51 @@ export ZSH_TMUX_UNICODE=true
 export ZSH_TMUX_AUTOQUIT=false
 export ZSH_TMUX_DEFAULT_SESSION_NAME=main
 
-# tms, https://github.com/jrmoulton/tmux-sessionizer
-export TMS_CONFIG_FILE="${XDG_CONFIG_HOME}/tms/config.toml"
+# tms (tmux session manager)
+msg "Setting up tms configuration"
+export TMS_CONFIG_FILE="$XDG_CONFIG_HOME/tms/config.toml"
 
 # wakatime, https://github.com/wakatime/wakatime-cli
 msg "Setting up Wakatime configuration"
 export WAKATIME_HOME="$XDG_STATE_HOME/wakatime"
 x-dc "$WAKATIME_HOME"
 
+# LM Studio CLI
+msg "Setting up LM Studio configuration"
+export PATH="$PATH:$HOME/.lmstudio/bin"
+
+# Screen
+msg "Setting up screen configuration"
+export SCREENRC="$XDG_CONFIG_HOME/misc/screenrc"
+
+# Zoxide
+msg "Setting up Zoxide configuration"
+export _ZO_DATA_DIR="$XDG_DATA_HOME/zoxide"
+export _ZO_EXCLUDE_DIRS="$XDG_DATA_HOME"
+
 # Misc
 msg "Setting up miscellaneous configuration"
 export ZSHZ_DATA="$XDG_STATE_HOME/z"
 export CHEAT_USE_FZF=true
 export SQLITE_HISTORY="${XDG_CACHE_HOME}/sqlite_history"
 
-[ -f "$XDG_CONFIG_HOME/exports-secret" ] && source "$XDG_CONFIG_HOME/exports-secret"
-[ -f "$XDG_CONFIG_HOME/exports-local" ] && source "$XDG_CONFIG_HOME/exports-local"
-[ -f "$XDG_CONFIG_HOME/exports-$(hostname)" ] && source "$XDG_CONFIG_HOME/exports-$(hostname)"
-[ -f "$XDG_CONFIG_HOME/exports-$(hostname)-secret" ] && source "$XDG_CONFIG_HOME/exports-$(hostname)-secret"
+# Additional PATH entries (aligned with fish config)
+[ -d "$XDG_DATA_HOME/mise/shims" ] && export PATH="$XDG_DATA_HOME/mise/shims:$PATH"
+[ -d "$YARN_GLOBAL_FOLDER/bin" ] && export PATH="$PATH:$YARN_GLOBAL_FOLDER/bin"
+[ -d "$MASON_HOME/bin" ] && export PATH="$PATH:$MASON_HOME/bin"
+[ -d "$HOME/.dotnet/tools" ] && export PATH="$PATH:$HOME/.dotnet/tools"
+[ -d "$POETRY_HOME/bin" ] && export PATH="$PATH:$POETRY_HOME/bin"
+[ -d "$HOME/.opencode/bin" ] && export PATH="$PATH:$HOME/.opencode/bin"
+
+# mise — unified tool version manager
+# https://mise.jdx.dev
+if command -v mise &> /dev/null; then
+  eval "$(mise activate bash)"
+fi
+
+if [ -f "$XDG_CONFIG_HOME/exports-secret" ]; then source "$XDG_CONFIG_HOME/exports-secret"; fi
+if [ -f "$XDG_CONFIG_HOME/exports-local" ]; then source "$XDG_CONFIG_HOME/exports-local"; fi
+# shellcheck source=./exports-lakka
+if [ -f "$XDG_CONFIG_HOME/exports-$(hostname)" ]; then source "$XDG_CONFIG_HOME/exports-$(hostname)"; fi
+# shellcheck source=./exports-lakka-secret
+if [ -f "$XDG_CONFIG_HOME/exports-$(hostname)-secret" ]; then source "$XDG_CONFIG_HOME/exports-$(hostname)-secret"; fi

config/exports-lakka

@@ -8,7 +8,6 @@ fi
 export PATH="$HOME/.local/go/bin:$PATH"
 
 alias logrotate='/usr/sbin/logrotate -s "$HOME/logs/state"'
-alias nano='nano -wS -$'
 alias gpg=gpg2
 
 ACME_PATH="$HOME/.acme.sh"

config/exports-secret.example

@@ -1,5 +1,3 @@
-#!/usr/bin/env bash
-#
 # This file is secret and wont be added to the git repo.
 
 export GITLAB_API_TOKEN=""

config/fish/alias.fish

@@ -1,14 +1,20 @@
 # Set aliases for fish shell
 
-alias vim='vim -u "$XDG_CONFIG_HOME/vim/vimrc"'
+if type -q nvim
+    alias vim='nvim'
+    alias vi='nvim'
+end
 
 # eza aliases if eza is installed
 if type -q eza >/dev/null
     function eza_git -d "Use eza and its git options if in a git repo"
         if git rev-parse --is-inside-work-tree &>/dev/null
-            eza --group-directories-first --icons=always --smart-group --git $argv
+            eza --group-directories-first --icons=always \
+                --smart-group --git $argv
         else
-            eza --group-directories-first --icons=always --smart-group $argv
+            eza --group-directories-first \
+                --icons=always \
+                --smart-group $argv
         end
     end
 
@@ -27,10 +33,25 @@ if type -q eza >/dev/null
     function l --wraps='eza_git' --description eza
         eza_git $argv
     end
+else
+    function ls --description 'ls (system fallback)'
+        command ls $argv
+    end
+    function ll --description 'ls -lh (system fallback)'
+        command ls -lh $argv
+    end
+    function l --description 'ls (system fallback)'
+        command ls $argv
+    end
+    function lsa --description 'ls -lah (system fallback)'
+        command ls -lah $argv
+    end
 end
 
 # Edit fish alias file
-function .a --wraps='nvim ~/.dotfiles/config/fish/alias.fish' --description 'edit alias.fish'
+function .a \
+    --wraps='nvim ~/.dotfiles/config/fish/alias.fish' \
+    --description 'edit alias.fish'
     nvim ~/.dotfiles/config/fish/alias.fish $argv
 end
 
@@ -55,7 +76,9 @@ function .p --wraps='cd ~/Code/ivuorinen' --description 'cd ~/Code/ivuorinen'
 end
 
 # shortcut to commit with a message
-function commit --wraps='git commit -a -m "chore: automated commit"' --description 'commit shortcut'
+function commit \
+    --wraps='git commit -a -m "chore: automated commit"' \
+    --description 'commit shortcut'
     set -l commitMessage $argv
     git add .
 
@@ -71,7 +94,8 @@ function commit --wraps='git commit -a -m "chore: automated commit"' --descripti
     git commit -a -m "$commitMessage"
 end
 
-function configure_tide --description 'Configure tide with the lean style and my preferences'
+function configure_tide \
+    --description 'Configure tide with the lean style and my preferences'
     tide configure \
         --auto \
         --style=Lean \
@@ -84,25 +108,43 @@ function configure_tide --description 'Configure tide with the lean style and my
         --transient=Yes
 end
 
-# Abbreviations for git
-abbr --add gau git add -u
-abbr --add gaa git add -A
-abbr --add gcv git commit -v
+# Navigation aliases
+abbr --add .. 'cd ..'
+abbr --add ... 'cd ../..'
+abbr --add .... 'cd ../../..'
 
-# Abbreviations for composer
-abbr --add c composer
-abbr --add cu composer update
-abbr --add ci composer install
+# Interesting folders
+function .b --wraps='cd $XDG_BIN_HOME' --description 'cd $XDG_BIN_HOME'
+    cd $XDG_BIN_HOME $argv
+end
 
-# Abbreviations for php artisan
-abbr --add .pa php artisan
-abbr --add .paf php artisan fresh
-abbr --add .pam php artisan migrate
-abbr --add .pams php artisan migrate --seed
-abbr --add .pat php artisan test
+function .l --wraps='cd ~/.local' --description 'cd ~/.local'
+    cd ~/.local $argv
+end
 
-# Abbreviations for npm
-abbr --add .n npm
-abbr --add .nt npm test --if-present
-abbr --add .nb npm run build --if-present
-abbr --add .ns npm run start --if-present
+function .o --wraps='cd ~/Code/ivuorinen/obsidian/' --description 'cd ~/Code/ivuorinen/obsidian/'
+    cd ~/Code/ivuorinen/obsidian/ $argv
+end
+
+# cd to git root directory
+function cdgr --description 'cd to git root'
+    if git rev-parse --is-inside-work-tree &>/dev/null
+        cd (git rev-parse --show-toplevel); or return $status
+    else
+        echo >&2 "Not in a git repository"
+        return 1
+    end
+end
+
+# Colored grep
+abbr --add grep 'grep --color'
+
+# Date helpers
+alias isodate="date +'%Y-%m-%d'"
+alias x-datetime="date +'%Y-%m-%d %H:%M:%S'"
+alias x-timestamp="date +'%s'"
+
+# Random abbreviations
+if type -q onefetch
+    abbr --add stats onefetch --nerd-fonts --true-color never
+end

config/fish/completions/app.fish

@@ -1,71 +0,0 @@
-# @halostatue/fish-macos/completions/app.fish:v7.0.1
-
-complete --command app --erase
-
-complete --command app --arguments bundleid \
-    --exclusive --condition __fish_use_subcommand \
-    --description 'Show bundle IDs for macOS apps'
-
-complete --command app --arguments find \
-    --exclusive --condition __fish_use_subcommand \
-    --description 'Find macOS apps by pattern'
-
-complete --command app --arguments frontmost \
-    --exclusive --condition __fish_use_subcommand \
-    --description 'Shows the front-most application'
-
-complete --command app --arguments icon \
-    --exclusive --condition __fish_use_subcommand \
-    --description 'Extracts a MacOS app icon as a png file'
-
-complete --command app --arguments quit \
-    --exclusive --condition __fish_use_subcommand \
-    --description 'Quit macOS apps by pattern'
-
-for subcommand in bundleid find
-    complete --command app --condition '__fish_seen_subcommand_from '$subcommand \
-        --short-option x --long-option exact --description 'Exact matches only'
-
-    complete --command app --condition '__fish_seen_subcommand_from '$subcommand \
-        --short-option a --long-option all --description 'Show all matches'
-
-    complete --command app --condition '__fish_seen_subcommand_from '$subcommand \
-        --short-option q --long-option quiet --description 'Quiet (show no output)'
-
-    complete --command app --condition '__fish_seen_subcommand_from '$subcommand \
-        --short-option h --long-option help --description 'Help for app '$subcommand
-end
-
-complete --command app --condition '__fish_seen_subcommand_from 'bundleid \
-    --short-option s --long-option short --description 'Show only the bundle ID'
-
-complete --command app --condition '__fish_seen_subcommand_from 'frontmost \
-    --short-option b --long-option bundle-id --description 'Shows the app bundle ID'
-complete --command app --condition '__fish_seen_subcommand_from 'frontmost \
-    --short-option p --long-option path --description 'Shows the app path'
-complete --command app --condition '__fish_seen_subcommand_from 'frontmost \
-    --short-option n --long-option name --description 'Shows the app name'
-complete --command app --condition '__fish_seen_subcommand_from 'frontmost \
-    --short-option P --long-option pid --description 'Shows the PID of the app'
-complete --command app --condition '__fish_seen_subcommand_from 'frontmost \
-    --short-option a --long-option all --description 'Shows all details'
-complete --command app --condition '__fish_seen_subcommand_from 'frontmost \
-    --short-option h --long-option help --description 'Help for app 'frontmost
-
-complete --command app --condition '__fish_seen_subcommand_from 'icon \
-    --short-option x --long-option exact --description 'Exact matches only'
-complete --command app --condition '__fish_seen_subcommand_from 'icon \
-    --short-option o --long-option output --description 'Extracts to this file or directory' \
-    --force-files
-complete --command app --condition '__fish_seen_subcommand_from 'icon \
-    --short-option w --long-option width --description 'Uses this pixel width' \
-    --no-files
-complete --command app --condition '__fish_seen_subcommand_from 'icon \
-    --short-option h --long-option help --description 'Help for app 'icon
-
-complete --command app --condition '__fish_seen_subcommand_from 'quit \
-    --short-option x --long-option exact --description 'Exact matches only'
-complete --command app --condition '__fish_seen_subcommand_from 'quit \
-    --short-option r --long-option restart --description 'Restart after quit'
-complete --command app --condition '__fish_seen_subcommand_from 'quit \
-    --short-option h --long-option help --description 'Help for app 'quit

config/fish/completions/aqua.fish

@@ -9,31 +9,31 @@ function __fish_aqua_no_subcommand --description 'Test if there has been any sub
     return 0
 end
 
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l log-level -r -d 'log level'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l config -s c -r -d 'configuration file path'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l disable-cosign -d 'Disable Cosign verification'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l disable-slsa -d 'Disable SLSA verification'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l disable-github-artifact-attestation -d 'Disable GitHub Artifact Attestations verification'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l trace -r -d 'trace output file path'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l cpu-profile -r -d 'cpu profile output file path'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l help -s h -d 'show help'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l version -s v -d 'print the version'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l help -s h -d 'show help'
-complete -c aqua -n '__fish_aqua_no_subcommand' -f -l version -s v -d 'print the version'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l log-level -r -d 'log level'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l config -s c -r -d 'configuration file path'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l disable-cosign -d 'Disable Cosign verification'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l disable-slsa -d 'Disable SLSA verification'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l disable-github-artifact-attestation -d 'Disable GitHub Artifact Attestations verification'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l trace -r -d 'trace output file path'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l cpu-profile -r -d 'cpu profile output file path'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l help -s h -d 'show help'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l version -s v -d 'print the version'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l help -s h -d 'show help'
+complete -c aqua -n __fish_aqua_no_subcommand -f -l version -s v -d 'print the version'
 complete -c aqua -n '__fish_seen_subcommand_from init' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'init' -d 'Create a configuration file if it doesn\'t exist'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a init -d 'Create a configuration file if it doesn\'t exist'
 complete -c aqua -n '__fish_seen_subcommand_from init' -f -l use-import-dir -s u -d 'Use import_dir'
-complete -c aqua -n '__fish_seen_subcommand_from init' -f -l import-dir -s i -r -d 'import_dir'
+complete -c aqua -n '__fish_seen_subcommand_from init' -f -l import-dir -s i -r -d import_dir
 complete -c aqua -n '__fish_seen_subcommand_from init' -f -l create-dir -s d -d 'Create a directory named aqua and create aqua.yaml in it'
 complete -c aqua -n '__fish_seen_subcommand_from install i' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'install i' -d 'Install tools'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'install i' -d 'Install tools'
 complete -c aqua -n '__fish_seen_subcommand_from install i' -f -l only-link -s l -d 'create links but skip downloading packages'
 complete -c aqua -n '__fish_seen_subcommand_from install i' -f -l test -d 'This flag was deprecated and had no meaning from aqua v2.0.0. This flag will be removed in aqua v3.0.0. https://github.com/aquaproj/aqua/issues/1691'
 complete -c aqua -n '__fish_seen_subcommand_from install i' -f -l all -s a -d 'install all aqua configuration packages'
 complete -c aqua -n '__fish_seen_subcommand_from install i' -f -l tags -s t -r -d 'filter installed packages with tags'
 complete -c aqua -n '__fish_seen_subcommand_from install i' -f -l exclude-tags -r -d 'exclude installed packages with tags'
 complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'generate g' -d 'Search packages in registries and output the configuration interactively'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'generate g' -d 'Search packages in registries and output the configuration interactively'
 complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l f -r -d 'the file path of packages list. When the value is "-", the list is passed from the standard input'
 complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l i -d 'Insert packages to configuration file'
 complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l pin -d 'Pin version'
@@ -43,14 +43,14 @@ complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l o -r -d 'inse
 complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l select-version -s s -d 'Select the installed version interactively. Default to display 30 versions, use --limit/-l to change it.'
 complete -c aqua -n '__fish_seen_subcommand_from generate g' -f -l limit -s l -r -d 'The maximum number of versions. Non-positive number refers to no limit.'
 complete -c aqua -n '__fish_seen_subcommand_from update-aqua upa' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'update-aqua upa' -d 'Update aqua'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'update-aqua upa' -d 'Update aqua'
 complete -c aqua -n '__fish_seen_subcommand_from update-checksum upc' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'update-checksum upc' -d 'Create or Update aqua-checksums.json'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'update-checksum upc' -d 'Create or Update aqua-checksums.json'
 complete -c aqua -n '__fish_seen_subcommand_from update-checksum upc' -f -l all -s a -d 'Create or Update all aqua-checksums.json including global configuration'
 complete -c aqua -n '__fish_seen_subcommand_from update-checksum upc' -f -l deep -d 'This flag was deprecated and had no meaning from aqua v2.0.0. This flag will be removed in aqua v3.0.0. https://github.com/aquaproj/aqua/issues/1769'
 complete -c aqua -n '__fish_seen_subcommand_from update-checksum upc' -f -l prune -d 'Remove unused checksums'
 complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'update up' -d 'Update registries and packages'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'update up' -d 'Update registries and packages'
 complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l i -d 'Select packages with fuzzy finder'
 complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l select-version -s s -d 'Select the version with fuzzy finder. Default to display 30 versions, use --limit/-l to change it.'
 complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l only-registry -s r -d 'Update only registries'
@@ -59,57 +59,57 @@ complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l limit -s l -r
 complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l tags -s t -r -d 'filter installed packages with tags'
 complete -c aqua -n '__fish_seen_subcommand_from update up' -f -l exclude-tags -r -d 'exclude installed packages with tags'
 complete -c aqua -n '__fish_seen_subcommand_from completion' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'completion' -d 'Output shell completion script for bash, zsh, or fish'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a completion -d 'Output shell completion script for bash, zsh, or fish'
 complete -c aqua -n '__fish_seen_subcommand_from completion' -f -l help -s h -d 'show help'
 complete -c aqua -n '__fish_seen_subcommand_from bash' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a 'bash' -d 'Output shell completion script for bash'
+complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a bash -d 'Output shell completion script for bash'
 complete -c aqua -n '__fish_seen_subcommand_from zsh' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a 'zsh' -d 'Output shell completion script for zsh'
+complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a zsh -d 'Output shell completion script for zsh'
 complete -c aqua -n '__fish_seen_subcommand_from fish' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a 'fish' -d 'Output shell completion script for fish'
+complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a fish -d 'Output shell completion script for fish'
 complete -c aqua -n '__fish_seen_subcommand_from fish' -f -l help -s h -d 'show help'
 complete -c aqua -n '__fish_seen_subcommand_from help h' -f -l help -s h -d 'show help'
 complete -r -c aqua -n '__fish_seen_subcommand_from fish' -a 'help h' -d 'Shows a list of commands or help for one command'
 complete -c aqua -n '__fish_seen_subcommand_from help h' -f -l help -s h -d 'show help'
 complete -r -c aqua -n '__fish_seen_subcommand_from completion' -a 'help h' -d 'Shows a list of commands or help for one command'
 complete -c aqua -n '__fish_seen_subcommand_from which' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'which' -d 'Output the absolute file path of the given command'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a which -d 'Output the absolute file path of the given command'
 complete -c aqua -n '__fish_seen_subcommand_from which' -f -l version -s v -d 'Output the given package version'
 complete -c aqua -n '__fish_seen_subcommand_from info' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'info' -d 'Show information'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a info -d 'Show information'
 complete -c aqua -n '__fish_seen_subcommand_from remove rm' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'remove rm' -d 'Uninstall packages'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'remove rm' -d 'Uninstall packages'
 complete -c aqua -n '__fish_seen_subcommand_from remove rm' -f -l all -s a -d 'uninstall all packages'
 complete -c aqua -n '__fish_seen_subcommand_from remove rm' -f -l mode -s m -r -d 'Removed target modes. l: link, p: package'
 complete -c aqua -n '__fish_seen_subcommand_from remove rm' -f -l i -d 'Select packages with a Fuzzy Finder'
 complete -c aqua -n '__fish_seen_subcommand_from vacuum' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'vacuum' -d 'Remove unused installed packages'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a vacuum -d 'Remove unused installed packages'
 complete -c aqua -n '__fish_seen_subcommand_from vacuum' -f -l init -d 'Create timestamp files.'
 complete -c aqua -n '__fish_seen_subcommand_from vacuum' -f -l days -s d -r -d 'Expiration days'
 complete -c aqua -n '__fish_seen_subcommand_from cp' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'cp' -d 'Copy executable files in a directory'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a cp -d 'Copy executable files in a directory'
 complete -c aqua -n '__fish_seen_subcommand_from cp' -f -l o -r -d 'destination directory'
 complete -c aqua -n '__fish_seen_subcommand_from cp' -f -l all -s a -d 'install all aqua configuration packages'
 complete -c aqua -n '__fish_seen_subcommand_from cp' -f -l tags -s t -r -d 'filter installed packages with tags'
 complete -c aqua -n '__fish_seen_subcommand_from cp' -f -l exclude-tags -r -d 'exclude installed packages with tags'
 complete -c aqua -n '__fish_seen_subcommand_from policy' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'policy' -d 'Manage Policy'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a policy -d 'Manage Policy'
 complete -c aqua -n '__fish_seen_subcommand_from allow' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_seen_subcommand_from policy' -a 'allow' -d 'Allow a policy file'
+complete -r -c aqua -n '__fish_seen_subcommand_from policy' -a allow -d 'Allow a policy file'
 complete -c aqua -n '__fish_seen_subcommand_from deny' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_seen_subcommand_from policy' -a 'deny' -d 'Deny a policy file'
+complete -r -c aqua -n '__fish_seen_subcommand_from policy' -a deny -d 'Deny a policy file'
 complete -c aqua -n '__fish_seen_subcommand_from init' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_seen_subcommand_from policy' -a 'init' -d 'Create a policy file if it doesn\'t exist'
+complete -r -c aqua -n '__fish_seen_subcommand_from policy' -a init -d 'Create a policy file if it doesn\'t exist'
 complete -c aqua -n '__fish_seen_subcommand_from init-policy' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'init-policy' -d '[Deprecated] Create a policy file if it doesn\'t exist'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a init-policy -d '[Deprecated] Create a policy file if it doesn\'t exist'
 complete -c aqua -n '__fish_seen_subcommand_from exec' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'exec' -d 'Execute tool'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a exec -d 'Execute tool'
 complete -c aqua -n '__fish_seen_subcommand_from list' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'list' -d 'List packages in Registries'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a list -d 'List packages in Registries'
 complete -c aqua -n '__fish_seen_subcommand_from list' -f -l installed -s i -d 'List installed packages'
 complete -c aqua -n '__fish_seen_subcommand_from list' -f -l all -s a -d 'List global configuration packages too'
 complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'generate-registry gr' -d 'Generate a registry\'s package configuration'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'generate-registry gr' -d 'Generate a registry\'s package configuration'
 complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l out-testdata -r -d 'A file path where the testdata is outputted'
 complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l cmd -r -d 'A list of commands joined with commas \',\''
 complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l generate-config -s c -r -d 'A configuration file path'
@@ -117,9 +117,8 @@ complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l lim
 complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l deep -d 'This flag was deprecated and had no meaning from aqua v2.15.0. This flag will be removed in aqua v3.0.0. https://github.com/aquaproj/aqua/issues/2351'
 complete -c aqua -n '__fish_seen_subcommand_from generate-registry gr' -f -l init -d 'Generate a configuration file'
 complete -c aqua -n '__fish_seen_subcommand_from version' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'version' -d 'Show version'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a version -d 'Show version'
 complete -c aqua -n '__fish_seen_subcommand_from root-dir' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'root-dir' -d 'Output the aqua root directory (AQUA_ROOT_DIR)'
+complete -r -c aqua -n __fish_aqua_no_subcommand -a root-dir -d 'Output the aqua root directory (AQUA_ROOT_DIR)'
 complete -c aqua -n '__fish_seen_subcommand_from help h' -f -l help -s h -d 'show help'
-complete -r -c aqua -n '__fish_aqua_no_subcommand' -a 'help h' -d 'Shows a list of commands or help for one command'
-
+complete -r -c aqua -n __fish_aqua_no_subcommand -a 'help h' -d 'Shows a list of commands or help for one command'

config/fish/completions/bob.fish

@@ -0,0 +1,71 @@
+# Print an optspec for argparse to handle cmd's options that are independent of any subcommand.
+function __fish_bob_global_optspecs
+    string join \n h/help V/version
+end
+
+function __fish_bob_needs_command
+    # Figure out if the current invocation already has a command.
+    set -l cmd (commandline -opc)
+    set -e cmd[1]
+    argparse -s (__fish_bob_global_optspecs) -- $cmd 2>/dev/null
+    or return
+    if set -q argv[1]
+        # Also print the command, so this can be used to figure out what it is.
+        echo $argv[1]
+        return 1
+    end
+    return 0
+end
+
+function __fish_bob_using_subcommand
+    set -l cmd (__fish_bob_needs_command)
+    test -z "$cmd"
+    and return 1
+    contains -- $cmd[1] $argv
+end
+
+complete -c bob -n __fish_bob_needs_command -s h -l help -d 'Print help'
+complete -c bob -n __fish_bob_needs_command -s V -l version -d 'Print version'
+complete -c bob -n __fish_bob_needs_command -f -a use -d 'Switch to the specified version, by default will auto-invoke install command if the version is not installed already'
+complete -c bob -n __fish_bob_needs_command -f -a install -d 'Install the specified version, can also be used to update out-of-date nightly version'
+complete -c bob -n __fish_bob_needs_command -f -a sync -d 'If Config::version_sync_file_location is set, the version in that file will be parsed and installed'
+complete -c bob -n __fish_bob_needs_command -f -a uninstall -d 'Uninstall the specified version'
+complete -c bob -n __fish_bob_needs_command -f -a rm -d 'Uninstall the specified version'
+complete -c bob -n __fish_bob_needs_command -f -a rollback -d 'Rollback to an existing nightly rollback'
+complete -c bob -n __fish_bob_needs_command -f -a erase -d 'Erase any change bob ever made, including neovim installation, neovim version downloads and registry changes'
+complete -c bob -n __fish_bob_needs_command -f -a list -d 'List all installed and used versions'
+complete -c bob -n __fish_bob_needs_command -f -a ls -d 'List all installed and used versions'
+complete -c bob -n __fish_bob_needs_command -f -a list-remote
+complete -c bob -n __fish_bob_needs_command -f -a ls-remote
+complete -c bob -n __fish_bob_needs_command -f -a complete -d 'Generate shell completion'
+complete -c bob -n __fish_bob_needs_command -f -a update -d 'Update existing version |nightly|stable|--all|'
+complete -c bob -n __fish_bob_needs_command -f -a run
+complete -c bob -n __fish_bob_needs_command -f -a help -d 'Print this message or the help of the given subcommand(s)'
+complete -c bob -n "__fish_bob_using_subcommand use" -s n -l no-install -d 'Whether not to auto-invoke install command'
+complete -c bob -n "__fish_bob_using_subcommand use" -s h -l help -d 'Print help (see more with \'--help\')'
+complete -c bob -n "__fish_bob_using_subcommand install" -s h -l help -d 'Print help (see more with \'--help\')'
+complete -c bob -n "__fish_bob_using_subcommand sync" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand uninstall" -s h -l help -d 'Print help (see more with \'--help\')'
+complete -c bob -n "__fish_bob_using_subcommand rm" -s h -l help -d 'Print help (see more with \'--help\')'
+complete -c bob -n "__fish_bob_using_subcommand rollback" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand erase" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand list" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand ls" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand list-remote" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand ls-remote" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand complete" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand update" -s a -l all -d 'Apply the update to all versions'
+complete -c bob -n "__fish_bob_using_subcommand update" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand run" -s h -l help -d 'Print help'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a use -d 'Switch to the specified version, by default will auto-invoke install command if the version is not installed already'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a install -d 'Install the specified version, can also be used to update out-of-date nightly version'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a sync -d 'If Config::version_sync_file_location is set, the version in that file will be parsed and installed'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a uninstall -d 'Uninstall the specified version'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a rollback -d 'Rollback to an existing nightly rollback'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a erase -d 'Erase any change bob ever made, including neovim installation, neovim version downloads and registry changes'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a list -d 'List all installed and used versions'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a list-remote
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a complete -d 'Generate shell completion'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a update -d 'Update existing version |nightly|stable|--all|'
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a run
+complete -c bob -n "__fish_bob_using_subcommand help; and not __fish_seen_subcommand_from use install sync uninstall rollback erase list list-remote complete update run help" -f -a help -d 'Print this message or the help of the given subcommand(s)'