CodeLayer v0.18.0 - December 1, 2025

This release brings improvements to file discovery and UI stability. The global shortcut is now customizable, and the thoughts directory works seamlessly even when gitignored.

Installation

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

Then launch "CodeLayer" from Spotlight/Raycast/Finder/etc.

Custom Environment Variables

If you need to set custom environment variables (e.g., for connecting to Bedrock or setting CLAUDE_BASE_MAINTAIN_WORKING_DIR=1),
you can set them in the env block of the built-in Claude Code Settings File

Loading Prompts

If you want to load the generic version of the HumanLayer prompts, check out this workshop gist

Frequently Asked Questions

Check out our FAQ for answers to common questions.

Features

• Customizable global shortcut - Configure or disable the global launcher shortcut (Cmd+Shift+H) in Settings -
• Thoughts directory file discovery - Files in thoughts/ now appear in @-mentions even when gitignored -
• Minimap icons - Visual icons in the session minimap for quick event type identification -
• Manual Claude path option - Set a custom Claude binary path when auto-detection fails -
• Open file hotkey - Press 'o' to quickly open files from event results -

Fixes

• Improved daemon stability - Removed unstable Bun worker threads from logging system -
• Fork modal overflow - Long file paths no longer break the fork modal layout -
• HLD database path - Fixed database path configuration for the HumanLayer daemon helper process -
• Logger improvements - Created reusable logger package with platform-specific implementations -

Changes

• Quick launcher footer - Shows current shortcut configuration with link to settings -
• Consolidated icon logic - Unified event icon rendering across all components -

Troubleshooting / Known Issues

• Logs can be found at ~/Library/Logs/dev.humanlayer.wui/CodeLayer.log
• If you see errors about missing mcp__codelayer__approvals tool, you're missing the humanlayer CLI - you need to install with brew, copying the app from a DMG won't work
• If install fails, ensure you've cleaned up all previous artifacts. brew reinstall is worth a shot as well