Skip to content

Installation ​

Requirements ​

  • macOS 12.0 (Monterey) or later
  • Xcode Command Line Tools

Quick Install ​

bash
# Clone the repository
git clone https://github.com/CosmoLabs-org/Cosmoscope.git
cd Cosmoscope

# Build and install
make install

Post-Install ​

  1. Open the app once: open ~/Applications/Cosmoscope.app
  2. Press Space on any code file in Finder to preview
  3. If another plugin handles the file, go to System Settings > General > Login Items & Extensions > Quick Look and enable Cosmoscope

Install from Binary ​

Download the latest release from GitHub Releases, then:

bash
unzip Cosmoscope.zip
cp -R Cosmoscope.app ~/Applications/

Install via Homebrew ​

A Homebrew Cask formula is included in the repository. Once a GitHub release is published:

bash
brew install --cask cosmoscope

To test the local cask before release:

bash
brew install --cask --no-quarantine Casks/cosmoscope.rb

Uninstall ​

bash
cosmoscope uninstall
# or
make uninstall