Installation
Requirements
- Go 1.25+ (for building from source)
- CGO enabled – required for SQLite3 with FTS5 support
- A C compiler (gcc or clang)
Build from Source
git clone https://github.com/szaher/claude-monitor.git
cd claude-monitor
make build
The binary is placed in bin/claude-monitor.
To install to /usr/local/bin:
make install
Download Pre-built Binary
Download the latest release for your platform from GitHub Releases:
| Platform | Architecture | Download |
|---|---|---|
| Linux | amd64 | claude-monitor-linux-amd64.tar.gz |
| Linux | arm64 | claude-monitor-linux-arm64.tar.gz |
| macOS | Intel | claude-monitor-darwin-amd64.tar.gz |
| macOS | Apple Silicon | claude-monitor-darwin-arm64.tar.gz |
# Example: macOS Apple Silicon
tar xzf claude-monitor-darwin-arm64.tar.gz
chmod +x claude-monitor
sudo mv claude-monitor /usr/local/bin/
Setup
After installing the binary, run the setup steps:
# 1. Install Claude Code hooks and initialize the database
claude-monitor install
# 2. Import existing session logs (optional but recommended)
claude-monitor import
# 3. Start the server and open the dashboard
claude-monitor serve
The install command does the following:
- Creates the data directory at
~/.claude-monitor/ - Initializes the SQLite database with all required tables
- Registers a Claude Code hook that sends events to the monitor
Verify Installation
# Check that the binary works
claude-monitor version
# Check hooks are installed and database is ready
claude-monitor status
Uninstall
# Remove hooks only
claude-monitor uninstall
# Remove hooks and delete all data
claude-monitor uninstall --delete-data