HumanLayer Docs

Release Notes ​

What's new in HumanLayer. The latest builds are always available at cloud.humanlayer.com/install.

0.128.0 — July 4, 2026 ​

This release is all about reliability. Sessions and the remote daemon now survive model refusals, duplicate-write hiccups, and single-session errors instead of failing or dropping your host — plus an "Archive Task" command-palette action and a new toggle to group artifacts by document type.

Highlights

  • Sessions survive model refusals — A model refusal that triggered a fallback (e.g. Fable 5 → Opus 4.8) used to kill the session with an "Internal server error" and lose the conversation. Now the fallback is surfaced inline, the session keeps going on the backup model, and the switch persists even if you interrupt and continue.
  • Archive Task from anywhere — "Archive Task" now appears in the Cmd+K command palette on the task page, a focused task-table row, or a focused kanban card — and kanban cards gain a right-click Archive.
  • Group artifacts by type — A new "Grouped" toggle in the artifacts sidebar organizes documents into sections by type (Research, Plan, Outline, …), so finding "the plan" is a glance, not a scan.

Other Changes

  • Remote daemon resilience — One session's error (a model/SDK failure or an API blip) no longer crashes the remote daemon and drops your host from the fleet; the bad session is marked failed and every other session keeps running.
  • Settings → Updates no longer crashes — The Updates page could crash before an update was available; updater metadata is now parsed safely.
  • Iterate button is easier to find — "Continue in New Session" keeps a "New Session" label at narrow composer widths instead of collapsing to a bare icon.
  • Daemon resource fix — Fixed a runaway CPU/memory loop that could occur when the daemon lost its parent process.

0.126.0 — July 2, 2026 ​

This release adds Sonnet 5 as a first-class model across HumanLayer, makes in-app update notes render as formatted Markdown, and fixes the buttons in HumanLayer Slack messages so clicking them no longer errors.

Highlights

  • Sonnet 5 support — Claude Sonnet 5 is now selectable in the Claude Code and CodeLayer Anthropic model pickers, the generic Sonnet option resolves to Sonnet 5, and the context gauge and token warnings use its full 1M-token window.
  • Formatted update notes — The "Update available" dialog and Settings → Updates now render release notes as formatted Markdown, with a scrollable body so the restart buttons stay reachable on longer notes; "View full changelog" opens the docs release-notes page.
  • Slack message buttons fixed — Clicking View artifact, View task, or Reply in HumanLayer in a HumanLayer Slack message no longer shows "App has not been configured for this feature" — the link just opens.

0.124.1 — June 26, 2026 ​

This release adds Slack notifications for tasks — connect your workspace and get artifact and comment activity posted right into your channels — and brings LaTeX math rendering to assistant messages, plus meaningful improvements to the Codex and outline-implementer agents.

Highlights

  • Slack notifications for tasks — Connect Slack under cloud.humanlayer.com → Settings → Slack and get task artifact and comment updates posted to your channels. Set up multiple automations with per-channel event and owner filters, messages are grouped into one thread per task, and task owners can mute a task's notifications. Only newly created artifacts and comments trigger a message, so edits stay quiet.
  • Math rendering in markdown — Assistant messages now render LaTeX math — inline $...$ and block $$...$$ — as properly formatted equations.
  • Codex image handling — Codex now passes images from file reads through as images instead of raw base64, so image-based tasks work correctly.
  • Smarter outline sub-agent — The outline implementer sub-agent now inherits the parent session's reasoning effort instead of always running at low effort.

Other Changes

  • Collaborative task navigation — Breadcrumbs and the Escape shortcut now return you to your Tasks view (not "Shared Tasks") for collaborative tasks you're actively working on.
  • Layered agent instructions — The CodeLayer agent now loads instructions from global, repo-root, and working-directory locations, including AGENTS.local.md / CLAUDE.local.md overrides.

0.122.1 — June 24, 2026 ​

This release lets you pick Kanban or the task table as your default task view, makes OAuth-authenticated MCP servers reliably available from the very start of a session, and corrects the context-window gauge for Codex sessions so it reflects the real limit. A couple of workflow and UI papercuts are fixed too.

Highlights

  • Choose your default task view — A new General Settings option lets you set Kanban or the task table as your default. Back-navigation, breadcrumbs, and Escape all respect your choice (Kanban stays the default for existing users).
  • OAuth MCP tools ready from the first turn — Sessions now wait for plugins to install and MCP servers to connect before the agent starts, so OAuth-authenticated MCP tools are reliably available from the start instead of appearing late or not at all.
  • Accurate Codex context gauge — Codex sessions now use the real ~258k context window instead of the public ~1M GPT-5 figure, so the token usage badge and near-limit warnings reflect how close you actually are.

Other Changes

  • Diagnostic dialog wraps long paths — The Claude diagnostic dialog now wraps long file paths and text instead of overflowing and pushing the action buttons offscreen.
  • Cleaner outline next-steps — Finishing or iterating a structure outline no longer suggests the retired /rpi:create-plan; it routes to /rpi:setup-worktree or /rpi:implement-outline based on your worktree timing.

0.121.0 — June 23, 2026 ​

This release makes artifact comments more resilient. In-progress comment drafts now survive accidental closes, navigation, and reloads, and a crash when opening design-phase artifacts with certain commented blocks is fixed.

Highlights

  • Comment drafts never get lost — New comment, reply, and edit drafts now persist across accidental dismissal, navigation, and reload, restoring automatically when you reopen. Drafts clear only on Submit or an explicit Discard. A faint "draft saved" label appears while an editor holds text.
  • Fixed artifact viewer crash — Opening a design-phase artifact whose comments were anchored to blocks with inline images or block math no longer crashes with "Something went wrong." Those comments now appear as gutter markers, and the viewer degrades gracefully if anything else goes wrong.

Other Changes

  • First-class Edit on comments — Editing a comment is now a dedicated Pencil button next to the resolve checkmark, with a clickable "edit in progress" badge when an unsaved edit survives a reload.

0.120.7 — June 22, 2026 ​

A focused release sharpening the planning workflows — PRD/TDD skills interview to a real decision before editing the doc, and describe-pr skips heavy walkthroughs on tiny PRs — plus cleaner docs URLs and a UI polish fix.

Highlights

  • Smarter PRD/TDD interviews — Planning skills now run each decision as an interview loop: clarifying questions and pushback continue the conversation instead of rewriting the doc on every message, so your spec stays stable while a decision is still being worked out.
  • Lighter PR descriptions on small diffs — describe-pr skips the interactive HTML walkthrough for small PRs (under 300 changed lines or fewer than 5 files), so quick changes get a quick description.
  • Clean docs URLs — docs.humanlayer.com now serves extensionless URLs (e.g. /guide/remote-daemons); old .html links still resolve.

Other Changes

  • Drag-and-drop overlay fix — The "drop files here" overlay now appears only in sessions attached to a task, where uploads actually work, instead of misleadingly showing on standalone sessions.
  • Markdown artifact guidance — Agents now open Markdown artifacts by file name from the Artifacts sidebar rather than attempting inline previews.

0.120.1 — June 21, 2026 ​

This release sharpens the multi-repo workspace experience, cleans up the first-run flow, and fixes a handful of draft and editing papercuts. New users land on a focused "Create Task" call-to-action, and multi-repo tasks now get a dedicated Workspace view with workspace-aware session launching.

Highlights

  • Multi-repo Workspace surfacing — Multi-repo tasks get a new Workspace sidebar tab listing every repo (primary badged), a "Workspace Root · N repos" row on the task summary, and a workspace-aware working-directory picker when launching new sessions. Single-repo tasks are unchanged.
  • Cleaner first-run experience — A workspace with no tasks now shows a centered "Create Task" empty state instead of empty Kanban columns, and the left sidebar stays hidden until you have a task of your own.
  • Auto-focus session prompt — Prompt editor focuses on navigation into a writable session to help avoid accidental hotkey triggers when intent is to author a user message.

Other Changes

  • Draft body now persists — Editing the body of an existing session draft and saving now keeps your changes (previously only the title was saved).
  • Remote daemon launch installs latest CLI — The remote daemon launch command now installs the latest @humanlayer/cli before running. This fixes a bug where sometimes the installed humanlayer cli was not available.
  • Refined Repositories header — Task form now lists only the names of the repos you actually selected, not every repo in the workspace.
  • Trust step in install command — The /install command now includes a brew trust --cask line ahead of install.
  • Worktree setup points to implement-outline — The setup-worktree flow now always suggests /rpi:implement-outline (never the retired implement-plan).

0.117.3 — June 19, 2026 ​

This release protects your unsaved draft work when you navigate away, fixes Claude Code occasionally falling back to an older Opus, and fixes auto-advance not firing for some worktree tasks. We also shipped this docs site at docs.humanlayer.com.

Watch the release video

Highlights

  • Unsaved drafts are protected — Navigating away from a draft or new-task form now auto-saves, prompts you to save, or lets you pass through cleanly instead of silently dropping your work.
  • Claude Code stays on the latest Opus — Fixed a bug where Claude Code sessions would sometimes default to Opus 4.5 instead of 4.8.
  • Auto-advance fix for worktree tasks — Fixed a bug where auto-advance would not fire in some cases for tasks in a worktree.
  • New docs site — Documentation now lives at docs.humanlayer.com, with pages for Overview, Remote daemons (CLI), and Codex CLI setup.

Fixes

  • Artifact sidebar sizing — Sidebar previews no longer collapse on narrow screens; a responsive comment gutter keeps avatars visible.
  • Draft sessions hidden from sidebar — The left-nav task tree excludes draft-status sessions, fixing stray entries and inaccurate unread/status.
  • @humanlayer/cli self-update runs in background — Self-update no longer blocks app startup.

0.115.2 — June 17, 2026 ​

Launch-day polish: production builds now generate the correct remote-daemon launch command, and the cloud install/onboarding page got a substantial rewrite to orient new users.

Highlights

  • Correct production daemon launch command — Production builds no longer emit --beta in the remote/browser daemon launch-token command, so the command copied from Settings → Daemons targets prod.
  • Revamped install/onboarding page — The install page now leads with outcomes, answers common first questions inline, tells Linux/Windows users how to run the daemon from a browser, and fixes the Artifacts sidebar link.
  • Lighter welcome email — The first onboarding email is now text-forward while keeping the product-tour link.

0.115.0 — June 17, 2026 ​

Small teams get a real free plan, Linear auto-advance comes to CodeLayer and Codex, and the TDD design interview gets sharper.

Highlights

  • Hobby free tier + one-click upgrade to Pro — New first-class HumanLayer Hobby plan for small teams (up to 3 active members plus pending invites), with a Stripe-hosted Upgrade to Pro flow in Billing settings and tier-specific copy for Hobby, Pro, and Enterprise.
  • Linear auto-advance in CodeLayer and Codex — Invoking an rpi:* skill now advances the linked Linear issue through your workflow columns in CodeLayer and Codex sessions, not just Claude Code.
  • TDD interview shows code, not prose — The create-tdd program-design interview now defaults to a code block per option so you compare actual shapes side-by-side.

Fixes

  • Lowercase Linear ticket IDs — Tickets like core-123 now resolve and advance.
  • Freeform ticket linkage — Freeform tasks created from a Linear or Jira ticket keep their ticket link.
  • Session UI selector gating — The new session page hides the HumanLayer/Terminal UI selector when the Claude Code Terminal UI experiment is off.

0.105.0 — June 11, 2026 ​

A read-only Kanban task board, editable queued messages, richer team metrics, and Fable 5 model support.

Watch the walkthrough video

Highlights

  • Kanban task board — Tasks now appear in a read-only workflow board with Todo/Draft, Research & Design, Planning, Implementation, and In Review columns.
  • Editable queued messages — Queued messages can now be edited in place before they are sent, with optimistic updates and graceful race handling.
  • Improved team metrics — The metrics page adds weekly active-user charts, collaboration metrics, CSV export, and user drill-downs.
  • Fable 5 model support — Adds Fable 5 to the Claude Code model dropdown.
  • Show skill contents — Skill tool calls now expose injected Claude skill prompts in the tool modal.
  • Claude Code diagnostics — Settings now shows Claude Code version and update information.
  • Model-aware context warnings — Context-window warnings adjust based on the selected model.

Fixes

  • More reliable sync and left nav — Fixed an issue where the left nav would not populate session data without a refresh.
  • Workflow graph stability — Session nodes stay visible while dragging in the task-page workflow graph.
  • Billing-blocked daemon heartbeat — Keeps daemon heartbeat behavior alive during billing-blocked states.
  • Queued message send-now flow — Fixes queued-message send-now behavior.
  • Tool result modal updates — Live-updates tool result modal content when tool responses arrive.
  • Auto-advance deduping — Makes auto-advance timestamp-aware so rewound sessions advance correctly.
  • Session titles — Uses <phase>: <task name> titles for auto-created phase sessions.
  • Org access requests — Suppresses spurious access requests for existing org members and improves sign-in-first access screens.

0.101.7 — June 6, 2026 ​

RPI becomes the default workflow for new tasks, plus a worktree-setup fix that could leave your main checkout as a bare repo and updated RPI skill prompts for Claude Opus 4.8.

Highlights

  • RPI is the new default workflow — Fresh users now land on the Research → Plan → Implement workflow in the New Task form instead of Freeform.
  • Worktree setup no longer leaves your repo bare — Fixes the bug where creating a task workspace could leave your main checkout acting as a bare repo, breaking git pull until manually repaired.
  • RPI skills updated for Claude Opus 4.8 — Removed references to the retired TodoWrite tool so the research, plan, and implement workflows behave correctly on Opus 4.8.
  • Daemon launch command fixed on production — The Settings dialog no longer incorrectly includes --beta in the daemon launch command on production builds.

Fixes

  • File-mention autocomplete — The @ autocomplete dropdown stays confined to the window instead of getting clipped off the right edge.
  • Sidebar create buttons — "Create Task" and "Create Session" are no longer hidden when the sidebar is empty or loading.
  • Artifact selection on session switch — "Send & Resolve" and the artifact preview now reset when switching sessions instead of showing a stale artifact.
  • Removed dead completed status — Sessions consistently show READY; the phantom completed state is gone.
  • Access-request archiving — Archiving now correctly ends the notification lifecycle.
  • Cloud favicons — The cloud dashboard and riptide-cloud now show a favicon in the browser tab.