codelayer-nightly-20250731

This release includes:

• CodeLayer - Desktop application (DMG installer)

Notes

• If you have a previous install, you will need to clean up / remove / stop previous bits (your sessions will persist!)
• if your claude cli is not in a very-default location like /usr/local/bin, you will need to launch with open /Applications/CodeLayer.app rather than launching from Spotlight/Finder/Raycast/etc

Installation Instructions

First: Cleanup

This installation is managed as a brew cask, if you have previously set up CodeLayer manually with a separate hld-darwin-arm64 process, you'll want to clean things up:

• Stop all running sessions

  • for running sessions, ctrl+x
  • for sessions awaiting approval, approve or deny, then ctrl+x
  • sessions that have a final assistant message and are in completed/interrupted state are safe to leave as is
  • (right now this is necessary to preserve sessions - the latest CodeLayer includes clean shutdown/recovery for sessions)

• Stop any running hld-darwin-arm64 process

• Remove any existing humanlayer cli (something like rm $(which humanlayer))

• Quit + remove any existing CodeLayer.app - rm -r /Applications/CodeLayer.app

• Install with brew cask and the --no-quarantine flag - This disables macOS gatekeeper - make sure you know what you're doing!

brew install --cask --no-quarantine humanlayer/humanlayer/codelayer

or if you prefer tapping directly you can do

brew tap humanlayer/humanlayer
brew install --cask --no-quarantine codelayer

Requirements

• macOS (Apple Silicon/M-series)

Troubleshooting / Known Issues

• If install fails, ensure you've cleaned up all previous artifacts. brew reinstall is worth a shot as well.
• Logs can be found at ~/Library/Logs/dev.humanlayer.wui/CodeLayer.log
• If daemon fails due to already running, you can pkill hld and reopen CodeLayer to try again
• If opening from spotlight/alfred/raycast/finder fails, try open /Applications/CodeLayer.app to push your PATH into CodeLayer so it can better find your claude CLI