Back to devlog

Blackcrab 0.2.0: a sharper interface for power users

A design-focused release that makes the desktop workspace denser, more keyboard-friendly, and more predictable in smaller windows while keeping the local Claude Code workflow intact.

A quieter shell for heavier work

Blackcrab 0.2.0 is mostly about the surface you live in while Claude Code is running. The app now uses a tighter, more minimal shell with less repeated chrome, a clearer command entry point, and a status bar that carries the details you need without turning the top of the app into a control panel.

The direction is deliberately closer to a focused editor than a marketing dashboard: compact rows, predictable controls, useful status, and fewer visual interruptions between sessions.

Density modes are now first-class

This release adds three layout densities: comfortable, compact, and focus. Compact is the default for a denser power-user workspace. Comfortable gives the interface more air. Focus hides the sidebar and tightens the shell for working inside one active conversation.

Density can be changed from Settings, the command palette, or the bottom status bar. The top-bar density control was removed so the setting is still available without being repeated in two places.

  • Comfortable mode for a roomier transcript and controls.
  • Compact mode for everyday power-user density.
  • Focus mode for a reduced single-session workspace.
  • Command palette entries for cycling or selecting density directly.

Navigation is faster from the keyboard

The command palette is now easier to reach from the main shell, and it includes commands for opening the next or previous recent session. That makes session switching less dependent on the sidebar when you already know you are moving through recent work.

Blackcrab also adds recent-session keyboard navigation with Command-Shift-[ and Command-Shift-] on macOS, with the equivalent Control modifier on other platforms.

Status moved where it belongs

The bottom status bar now carries the active session id, current project folder, branch state, selected model, permission mode, context tokens, estimated cost, tool count, attention queue, diagnostics, and layout density. The goal is to make the running state visible without competing with the transcript.

This is especially useful when multiple sessions are active. The app can show what is connected, what is running, and what needs attention while leaving the main pane for the conversation and tool output.

Windowed mode behaves better

A smaller but important fix: the app should no longer clip off the right side of the UI when it is not fullscreen. The sidebar collapses at narrower widths, the preview pane has responsive width caps, and compact labels keep the status area from forcing horizontal overflow.

That matters on laptops and split-screen desktops, where a power-user tool has to work in the actual window size people give it, not only in a perfect fullscreen layout.

Authentication startup is safer

This release also includes the Claude authentication fix from the 0.2.0 branch. When normal Claude Code CLI authentication is available, Blackcrab now avoids passing stale Anthropic credential override environment variables into spawned Claude processes.

That should reduce the recurring 401 failure mode where an old token overrides a valid local CLI login when starting or continuing sessions.

Upgrade notes

Blackcrab 0.2.0 ships signed updater artifacts and fresh installers for macOS, Windows, and Linux through GitHub Releases. Existing users should be able to update through the app once the updater check sees the published release.

There are no manual migration steps for this release. If the updater does not appear immediately, downloading a fresh installer from the releases page is still safe.

More devlog

Release notes

What changed in Blackcrab 0.1.1 and 0.1.2

The first two updates after the initial preview focused on making Blackcrab more reliable as a daily Claude Code workspace: better attention signals, safer handoffs, usage dashboards, project reporting, faster search, and signed update artifacts.

Design note

Why Blackcrab is a desktop app

The product is not trying to hide Claude Code. It gives the CLI a native workspace for parallel sessions, local context, and the parts of agent work that are easier to manage visually.

Product devlog

Designing the tiled session grid

Running one agent at a time is simple, but it leaves a lot of attention unused. The grid is Blackcrab's attempt to make parallel agent work legible without turning it into a control room.

Engineering

What local-first means for Blackcrab

Local-first is not a vibe for this product. It is a practical constraint around where transcripts live, how Claude Code runs, and what kind of trust the app should ask for.