Custom Update Hooks for Third-Party Software (Claude Code, Flatpak, etc.)

[ibihim]

Problem

Some software doesn't fit well into Omarchy's package management:

• Official releases that are not happy to be installed differently (e.g., Claude Code throws errors/warnings when installed via omarchy)
• Official Flatpaks/Snaps instead of AUR wrappers
• Other tooling that needs updating alongside the system

Right now, these have to be updated manually or via separate scripts, which fragments the update experience.

Proposal

Add support for user-defined update hooks in omarchy-update, so we can run custom scripts alongside system updates.

Possible Implementation

Something like:

  ~/.config/omarchy/update-hooks.d/
    ├── pre/
    │   └── 00-backup.sh
    └── post/
        ├── 10-claude-code.sh
        └── 20-flatpak.sh

These would run:

• pre/ - Before the main update
• post/ - After the main update succeeds

Example Hook

  #!/bin/bash
  # ~/.config/omarchy/update-hooks.d/post/10-claude-code.sh

  echo "Updating Claude Code..."
  if command -v claude &> /dev/null; then
      claude update
  fi

Similar Patterns

Other tools do this successfully:

• pacman has /etc/pacman.d/hooks/
• apt has /etc/apt/apt.conf.d/
• systemd has drop-in directories

Questions

1. Does this fit Omarchy's philosophy?
2. Would this be useful for others?
3. Any concerns about security or complexity?

Outlook

This hooking could be useful to overwrite the keybindings as well.
E.g. I am not using X and I would like to re-arrange some keybindings.
If those would be in a hook file, it might be easier to update without conflicts / backup files.

[ibihim]

Is it expected to put such scripts into ~/.config/omarchy/hooks/post-update or is this solely for Omarchy?

[cau1k]

Would make it nice to have hooks for config updates as well for those managing dots with sym link farms (stow, chezmoi, etc).