codelayer-20250807-nightly-test

This release includes:

• CodeLayer - Desktop application (DMG installer)

TLDR

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

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

Then, you can run it with

open /Applications/CodeLayer-Nightly.app

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

codelayer-20250806-nightly-test

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

Then, you can run it with

open /Applications/CodeLayer.app

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

codelayer-20250805-nightly-test

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

Then, you can run it with

open /Applications/CodeLayer.app

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

codelayer-20250805-nightly

This release includes:

• CodeLayer - Desktop application (DMG installer)

Notes

• 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

• 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-nightly

or if you prefer tapping directly you can do

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

Then, you can run it with

open /Applications/CodeLayer.app

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

codelayer-20250804_234935

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

Then, you can run it with

open /Applications/CodeLayer.app

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

codelayer-20250804-nightly

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

Then, you can run it with

open /Applications/CodeLayer.app

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

codelayer-20250803-nightly

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

Then, you can run it with

open /Applications/CodeLayer.app

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

codelayer-20250802_000111

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

Then, you can run it with

open /Applications/CodeLayer.app

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

🎉 What's New

Major Milestone: Single Installation Experience

• Bundle daemon and CLI with WUI for single-installation experience: This eliminates the setup friction that affected our first users!

Key Improvements

• Enhanced daemon shutdown behavior with proper session cleanup
• Fixed UI inconsistencies and improved user experience
• Resolved archive tab display issues

Installation & Setup

• Single Package Installation: The daemon and CLI are now bundled with the Web UI, providing a seamless one-step installation process

UI/UX Improvements

• Fixed Archive Display: Archive tab now correctly shows only archived sessions
• Consistent Keyboard Shortcuts: Message submission shortcuts are now consistent between new and existing sessions
• Visual Clarity: Improved markdown bullet rendering to avoid confusion with dropdowns
• Theme Support: Merged Tom's Rose Pine theme contribution

Stability & Performance

• Graceful Shutdown: Daemon now properly stops running sessions on shutdown with a 5-second timeout, preventing data loss

Bug Fixes

• Auto-Accept Indicator: Fixed issue where auto-accept indicator would disappear after focus changes
• Approval Notifications: Fixed issue where approvals would appear when using Shift+Tab

Developer Experience

• Improved Planning Prompts: The create_plan prompt now more explicitly shows the end goal for better context

🙏 Thanks

Special thanks to:

• @tomnagengast for the Rose Pine theme contribution
• @a-churchill from @workweave for the valuable feedback
• All our alpha testers providing crucial early feedback

📝 Feedback

We'd love to hear your feedback! Press the feedback button in CodeLayer or use Command+Shift+F to share your experience.

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

HumanLayer 20250730 - macOS Release

This release includes:

• CodeLayer - Desktop application (DMG installer)
• HumanLayer Daemon (hld) - Command-line daemon (ARM64 binary)

Installation Instructions

• Install the CLI: npm install -g humanlayer@0.11.0
• Download daemon binary (hld-darwin-arm64)
• Run it in a terminal e.g. chmod +x ~/Downloads/hld-darwin-arm64 && ~/Downloads/hld-darwin-arm64
• Dismiss the security modal
• Go to System Settings > Privacy & Security and scroll to the bottom, find the "allow" button and click it
• Run it again ~/Downloads/hld-darwin-arm64
• Download CodeLayer (CodeLayer.dmg)
• Copy the app to Applications
• Open CodeLayer with your preferred app launcher
• Dismiss security modal
• Go to System Settings > Privacy & Security and allow
• Open CodeLayer again

Requirements

• macOS (Apple Silicon/M-series)
• Node.js installed