Skip to main content

​
Requirements

The fastest way to install Monocle on macOS or Linux: 
brew install josephschmitt/tap/monocle
Homebrew handles updates automatically with brew upgrade monocle.

​
Pre-built binaries

Download the binary for your platform from GitHub Releases, extract it, and move it to a directory on your PATH. 
curl -Lo monocle.tar.gz https://github.com/josephschmitt/monocle/releases/download/v0.38.0/monocle_darwin_arm64.tar.gz
tar xzf monocle.tar.gz
sudo mv monocle /usr/local/bin/

​
Build from source

If you prefer to build Monocle yourself, you’ll need devbox to set up the Go environment: 
git clone https://github.com/josephschmitt/monocle.git
cd monocle
devbox run -- make build
The compiled binary is placed in bin/. Copy it to a directory on your PATH: 
sudo cp bin/monocle /usr/local/bin/

​
Verify the installation

Confirm Monocle is installed and on your PATH: 
monocle --version
You should see the installed version number printed to the terminal.

​
The --global flag

Many Monocle commands accept a --global flag. Without it, Monocle writes configuration (skills, MCP channel config) into the current project directory — for example, .claude/skills/ in your repo. With --global, it writes to your user-level config directory instead, so the same configuration applies across all your projects.
Project-level configuration takes precedence over global configuration. Register Monocle globally with monocle register --global if you want it available in every project without running monocle register per repo.

​
Next steps

Once Monocle is installed, register it with your agent and start a review session:

Quickstart

Register Monocle with your agent and run your first live review in minutes.

Build docs developers (and LLMs) love

Get started for freeTalk to us