Skip to main content

Prebuilt .deb

The .deb is the only supported install path for v1. It bundles the daemon, the hook scripts, the ccmon CLI, and the desktop UI into a single installable — no Python or Node runtime needed on your machine.

Requirements​

  • Linux — only platform supported in v1.
  • claude CLI on PATH, already authenticated.
  • notify-send for desktop notifications: 
    sudo apt install libnotify-bin
    Optional, but strongly recommended.

Download​

Currently only amd64 is published — check yours with dpkg --print-architecture.

curl -LO https://github.com/Skyscimitar/ccmon-release/releases/latest/download/ccmon_0.1.0_amd64.deb
curl -LO https://github.com/Skyscimitar/ccmon-release/releases/latest/download/ccmon_0.1.0_amd64.deb.sha256

The version on this page (0.1.0) tracks the latest documented release; older versions remain available on the releases page.

Verify the download before installing:

sha256sum -c ccmon_0.1.0_amd64.deb.sha256

Install​

sudo dpkg -i ccmon_0.1.0_amd64.deb
sudo apt -f install   # only if a dependency was missing

This installs:

  • /usr/bin/{ccmon, ccmon-daemon, ccmon-event, ccmon-approve, ccmon-ui}
  • A .desktop entry that registers the ccmon:// URL scheme
  • A systemd user unit at /usr/lib/systemd/user/ccmon-daemon.service
  • The app icon

First run​

ccmon install                              # wire hooks into ~/.claude/settings.json
systemctl --user daemon-reload
systemctl --user enable --now ccmon-daemon # auto-start the daemon
# Launch "ccmon" from your applications menu

ccmon install merges entries into ~/.claude/settings.json — your existing hooks are preserved, and ccmon's entries are tagged "_ccmon": true so ccmon uninstall can remove them cleanly later.

tip

Run ccmon doctor after installation to confirm everything is wired up — see Configuration for the expected output.

Uninstall​

ccmon uninstall                            # remove hooks
systemctl --user disable --now ccmon-daemon
sudo apt remove ccmon

Removing ~/.local/state/ccmon/ is a clean state reset — the next daemon start recreates everything.