CodeLayer v0.16.5 - November 11, 2025

This release brings the most-requested CodeLayer feature - bundled prompts & subagents in the product! We've also improved developer experience with quick editor access, enhanced slash command reliability, and solidified our build infrastructure for stable releases.

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

Developer Experience (New in v0.16.2)

• Prompts and Subagents Bundled - CodeLayer now includes our battle-tested prompts and subagents - select and bootstrap them directly into your working directory
• Open in Editor Button - Quick access to open sessions directly in your preferred editor - @balanceiskey (#35)
• Agent Discovery Improvements - Better inline bootstrap status in agent discovery API (#29)

Fixes

Reliability Improvements (New in v0.16.2)

• Slash Command Reliability - Fixed parsing issues with non-breaking spaces in user input - @balanceiskey (#38)
• Slash Command API - Made workingDir optional to prevent command failures (#45)
• ExitPlanMode Handling - Improved denial reason handling for plan mode exits (#28)
• Split View Bugs - Fixed clicking issues in message stream split view (#31)
• Various UI Fixes - Resolved multiple UI bugs and edge cases (#32)

Infrastructure

Build System (v0.16.2 - v0.16.5)

• Build Performance - Migrated to depot.dev runners for faster CI/CD (#20)
• Turborepo Integration - Improved Linear workflows with turborepo build system (#24)
• Storybook Configurations - Separated Storybook configs for better modularity (#27)
• Build System Fixes - Fixed setup scripts and dependency issues (#40)
• Workflow Stability - Resolved critical workflow and caching issues for stable releases - @K-Mistele (#47)
• Authentication Infrastructure - Added auth foundation for upcoming CodeLayer Pro features - @K-Mistele (#46)

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

CodeLayer Stable Release

Version: 0.16.4

Installation

Homebrew (Recommended)

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

Manual Installation

1. Download the DMG file below
2. Open the DMG and drag CodeLayer to Applications
3. Launch CodeLayer from Applications

Troubleshooting

If you encounter "damaged app" warnings:

xattr -rc /Applications/CodeLayer.app

Logs

Logs can be found at:

~/Library/Logs/dev.humanlayer.wui/CodeLayer.log

CodeLayer Stable Release

Version: 0.16.3

Installation

Homebrew (Recommended)

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

Manual Installation

1. Download the DMG file below
2. Open the DMG and drag CodeLayer to Applications
3. Launch CodeLayer from Applications

Troubleshooting

If you encounter "damaged app" warnings:

xattr -rc /Applications/CodeLayer.app

Logs

Logs can be found at:

~/Library/Logs/dev.humanlayer.wui/CodeLayer.log

CodeLayer v0.16.2 - November 10, 2025

This release ships the most-requested CodeLayer feature - bundling our prompts & subagents into the product!

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

Frequently Asked Questions

Check out our FAQ for answers to common questions.

Features

Developer Experience

• Prompts and sub-agents in Codelayer: Codelayer now bundles our prompts and sub-agents, which you can bootstrap into a working directory by selecting one of them and launching the session
• Open in Editor Button - Quick access to open sessions directly in your editor (#35)
• Agent Discovery Improvements - Better inline bootstrap status in agent discovery API (#29)

Fixes

• Slash Command Reliability - Fixed parsing issues with non-breaking spaces in user input (#38)
• Slash Command API - Made workingDir optional to prevent command failures (#45)
• ExitPlanMode Handling - Improved denial reason handling for plan mode exits (#28)
• Split View Bugs - Fixed clicking issues in message stream split view (#31)
• Various UI Fixes - Resolved multiple UI bugs and edge cases (#32)

Infrastructure

• Build Performance - Migrated to depot.dev runners for faster CI/CD (#20)
• Turborepo Integration - Improved Linear workflows with turborepo build system (#24)
• Storybook Configurations - Separated Storybook configs for better modularity (#27)
• Build System Fixes - Fixed setup scripts and dependency issues (#40)

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

CodeLayer Stable Release

Version: 0.16.1

Installation

Homebrew (Recommended)

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

Manual Installation

1. Download the DMG file below
2. Open the DMG and drag CodeLayer to Applications
3. Launch CodeLayer from Applications

Troubleshooting

If you encounter "damaged app" warnings:

xattr -rc /Applications/CodeLayer.app

Logs

Logs can be found at:

~/Library/Logs/dev.humanlayer.wui/CodeLayer.log

CodeLayer Stable Release

Version: 0.1.0-stable-20251111054835

Installation

Homebrew (Recommended)

brew tap humanlayer/humanlayer
brew install --cask codelayer

Manual Installation

1. Download the DMG file below
2. Open the DMG and drag CodeLayer to Applications
3. Launch CodeLayer from Applications

Troubleshooting

If you encounter "damaged app" warnings on macOS:

xattr -rc /Applications/CodeLayer.app

Logs

Logs can be found at:

~/Library/Logs/dev.humanlayer.wui/CodeLayer.log

CodeLayer v0.16.0 - November 3, 2025

This release brings critical stability improvements and bug fixes, including resolution of text persistence issues, model configuration during forking, and auto-acceptance of pending edits. The @-mentioning system has been enhanced, and we've improved our build infrastructure for better reliability.

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

• Auto-approve pending edit approvals when AutoAcceptEdits is enabled - @balanceiskey (#12)
• Port sub-agent message handling and fuzzy search width fixes - @balanceiskey (#5)
• humanlayer CLI now built with bun as a native executable and distributed as codelayer, codelayer-nightly etc. depending on the cask

Fixes

• Model configuration now correctly persists when forking sessions - @balanceiskey (#17)
• Text no longer disappears during task status changes - @balanceiskey (#15)
• Un-sent session prompt inputs should not longer be selected/highlighted when focusing the codelayer window after a previous blur - @balanceiskey (#15)
• @-mentioning file paths now properly serializes full paths - @balanceiskey (#10)
• Fixed draft bypass permissions timeout inheritance bug - @balanceiskey (#11)
• Resolved first typed character clearing content issue - @balanceiskey (#2)

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
• Run into a bug? Hit cmd+shift+f to share your feedback!

CodeLayer Pro Release

Version: v0.0.3

🚀 Pro Edition\n\nThis is the Pro edition of CodeLayer with enhanced features and dedicated support.\n

Installation

Homebrew (Recommended)

brew tap humanlayer/humanlayer
brew install --cask codelayer-pro

Manual Installation

1. Download the DMG file below
2. Open the DMG and drag CodeLayer-Pro to Applications
3. Launch CodeLayer-Pro from Applications

Troubleshooting

If you encounter "damaged app" warnings on macOS:

xattr -rc /Applications/CodeLayer-Pro.app

Logs

Logs can be found at:

~/Library/Logs/dev.humanlayer.wui.pro/CodeLayer-Pro.log

CodeLayer Pro Release

Version: 0.0.4

🚀 Pro Edition\n\nThis is the Pro edition of CodeLayer with enhanced features and dedicated support.\n

Installation

Homebrew (Recommended)

brew tap humanlayer/humanlayer
brew install --cask codelayer-pro

Manual Installation

1. Download the DMG file below
2. Open the DMG and drag CodeLayer-Pro to Applications
3. Launch CodeLayer-Pro from Applications

Troubleshooting

If you encounter "damaged app" warnings on macOS:

xattr -rc /Applications/CodeLayer-Pro.app

Logs

Logs can be found at:

~/Library/Logs/dev.humanlayer.wui.pro/CodeLayer-Pro.log