Skip to content

Install and run

topd wiki sync edited this page Nov 17, 2026 · 1 revision

Install and run

Requirements

  • macOS 14 or later
  • Xcode Command Line Tools: xcode-select --install

Steps

git clone https://github.com/sorens-co/topd.git
cd topd
./run.sh

run.sh builds a release app, wraps it as .build/topd.app, signs it locally, and starts it. The first build takes a few minutes. Look for the topd icon in the menu bar. There is no Dock icon.

Stop, restart, update

pkill -x topd                       # stop
pkill -x topd; ./run.sh             # restart after changes
git pull && pkill -x topd; ./run.sh # update

Optional alias

alias topd='/absolute/path/to/topd/run.sh'

Add it to ~/.zshrc, then run source ~/.zshrc.

Clone this wiki locally