Skip to content

devlog.md

Latest commit

 

History

History
80 lines (50 loc) · 3.9 KB

devlog.md

File metadata and controls

80 lines (50 loc) · 3.9 KB
Raw

Plan for upgrading dotfile setup

07/2025

  1. Identify candidates for mise management: DONE
  • Review executable_install-my-packages.tmpl to find tools installed via brew and apt.
  • Review home/private_dot_config/git/config.tmpl to find tools used in git aliases and configurations.
  • Cross-reference the findings with available-mise-tools.txt.
  • Create a list of tools to migrate to mise in tools-to-move.txt.
  1. Refactor git configuration: DONE
  • Replace icdiff with difftastic in home/private_dot_config/git/config.tmpl.
  • Add difftastic to tools-to-move.txt.
  • Update home/private_dot_config/git/config.tmpl to use SSH keys instead of GPG for signing.
  • Undo migration to SSH, it sucks, continue using GPG for signing.
  1. Future/pending actions: DONE
  • Investigate git-who and consider managing it with chezmoiexternals.
  • Move the remaining tools from tools-to-move.txt to be installed via mise.
  1. End-to-End Installation Test: DONE
  • Create a test script (test-installation.sh).
  • The script will spin up a fresh Ubuntu Docker container to run the test.
  • It will execute the main install.sh script inside the container.
  • The Docker host will be configurable via a DOCKER_HOST environment variable.
  • The test will verify that key tools are installed and available on the PATH.
  • The test will run chezmoi verify to ensure the dotfiles are correctly applied.
  1. Support all shells DONE

  • Switch from ~/.zshrc.d to XDG standard ~/.config/zsh.

  • Prepare new shell init dotfiles: ~/.zshenv, ~/.config/zsh/.zprofile, ~/.config/zsh/.zshrc

  • Define modular init scripts for above new zsh dotfiles: env.zsh.tmpl, login.zsh, options.zsh.tmpl, plugins.zsh.tmpl, prompt.zsh.tmpl

  • Heavily document init lifecycle touchpoints and purpose of the above dotfiles / modular init scripts.

  • Audit the monolithic ~/.config/zsh/init.zsh, and split it into the above boundaries.

    • The audit of init.zsh has defined the following boundaries for splitting the file:

      • env.zsh.tmpl: Responsible for sourcing environment-specific variables and configurations. The audit identified that ~/.aliases should be sourced here too.

      • login.zsh.tmpl: To handle logic that should only run during a login shell, such as the tmux session resumption.

      • options.zsh.tmpl: This file will contain all shell setopt configurations. The audit has identified that history settings and the PROFILE_STARTUP debugging options belong here.

      • plugins.zsh.tmpl: Will be responsible for managing all zplug plugins and their configurations. This includes initializing zplug, declaring all plugins, loading them, and setting up compinit for completions.

      • prompt.zsh.tmpl: This file's responsibility is to configure the shell's interactive appearance. The audit has identified that terminal reset, clearing the screen, and the welcome messages belong here.

  • Split the ~/.config/zsh/init.zsh.

  • Test to ensure all init modules are loaded correctly, for all shells; login/non-login, interactive/non-interactive

  1. Ensure install.sh works on fresh systems TODO
  • [] The curl install.sh | bash method should work e.g. fix BASH_SOURCE[0] error
  • [] Fix the readme (contains a typo for the curl example e.g. "^" instead of "_")

  1. Create bin stubs for MCP stdio tools TODO

  2. Prompt Migration: Pure to Starship TODO

  • [] Replace the pure prompt with starship.
  • [] Install starship via mise.
  • [] Configure starship to match the existing pure prompt's look and feel.
  • [] Remove pure from .chezmoiexternals/zsh.toml.tmpl.
  1. Terminal History Improvement: Atuin TODO
  • [] Replace the default shell history with atuin.
  • [] Install atuin via mise.
  • [] Configure the shell to integrate with atuin.
  • [] Ensure history is synced across sessions.