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