Skip to content

Releases

Deckhand 0.1.9 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 14 Nov 05:12

Tenth alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No new firmware is needed for this release.

What's new

  • Codex in auto mode no longer shows "needs input". In auto mode, Codex's own reviewer approves commands, but Codex still told Deckhand about each approval as if it were a question for you. So the session showed "needs input" the whole time, and each approval waited 15 seconds for a tap on the display before Codex carried on. Deckhand now checks the session's approval setting: approvals Codex handles itself keep the session "working" and run without the wait. When Codex really is asking you, it shows on the display as before.

Nothing else changes from 0.1.8.

Install (new users)

  1. Download Deckhand-0.1.9.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Known limits

With Claude Code switched off on the Agents pane, the display's usage cards show dashes rather than disappearing; the firmware is unchanged.

Still not verified

Whether Codex's auto-reviewer can ever hand a request back to you; the USAGE tab with Codex and Antigravity both reporting, on the display itself; anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall.

Feedback and bug reports: Issues.

Deckhand 0.1.8 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 14 Nov 02:48

Ninth alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No new firmware is needed for this release.

What's new

  • Every session in the menu shows which agent it belongs to. Each row now starts with CC, CODEX or AGY, in a column of its own so the project names line up. Before, only Codex and Antigravity sessions were labelled, faintly and after the project name, while Claude Code sessions had no label. The display already labels every session, and is unchanged.

Nothing else changes from 0.1.7, including the Agents switches and the fix that keeps long-running sessions listed.

Install (new users)

  1. Download Deckhand-0.1.8.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Known limits

With Claude Code switched off on the Agents pane, the display's usage cards show dashes rather than disappearing; the firmware is unchanged.

Still not verified

The USAGE tab with Codex and Antigravity both reporting, on the display itself; anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall.

Feedback and bug reports: Issues.

Deckhand 0.1.7 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 13 Nov 20:52

Eighth alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No new firmware is needed for this release.

What's new

  • Sessions no longer disappear while a long task runs. A Claude Code session that went 20 minutes without activity, for example while waiting on a long background task, was dropped from the session counts and the display. Deckhand now checks whether the session's Claude process is still running: an open session stays however quiet it is, and one whose process has exited shows as ended straight away instead of lingering for 20 minutes. Codex and Antigravity sessions keep the old 20-minute rule. A session already dropped by an earlier version comes back the next time it does anything.

  • Settings > Agents: switch Claude Code, Codex or Antigravity off completely. Each agent has three switches:

    • On. When it is off, Deckhand stops reading that agent's usage (no more background agy or Codex refresh runs). Its sessions are left out of the menu bar, the menu and the display, and its hooks never wait on the display.
    • Usage beside the icon. This moved here from the Menu Bar pane.
    • Usage in the menu. This one is new.

    With both display switches off, the agent is still tracked and still shown on the display, but not on the Mac.

Install (new users)

  1. Download Deckhand-0.1.7.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Known limits

With Claude Code off, the display's usage cards show dashes rather than disappearing; the firmware is unchanged in this release.

Still not verified

The USAGE tab with Codex and Antigravity both reporting, on the display itself; anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall.

Feedback and bug reports: Issues.

Deckhand 0.1.6 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 13 Nov 11:46

Seventh alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No new firmware is needed for this release.

What's new

  • The restart log tells the truth again. Since 0.1.5, the background host clears its status file when it stops cleanly, so the menu bar shows "Stopped" at once. That also left the restart history (deckhand-service.sh status) saying every clean restart had "last tick unknown (... /tmp cleared?)". The host now records its last tick before it exits, so a clean restart reads as one, and a host that had stalled before it was stopped is still reported as stalled.

Nothing else changes from 0.1.5, including its much lower memory use.

Install (new users)

  1. Download Deckhand-0.1.6.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Still not verified

Memory use over a full day on 0.1.5 and later (measured at 13 minutes so far); the USAGE tab with Codex and Antigravity both reporting, on the display itself; anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall.

Feedback and bug reports: Issues.

Deckhand 0.1.5 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 13 Nov 11:27

Sixth alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No new firmware is needed for this release.

What's new

  • Gigabytes less memory. Deckhand used to run a usage tool (ccusage) that re-read every Claude Code transcript you have on every update, about 1.25 GB each time, two at once, almost continuously. Deckhand now counts tokens itself, reading each transcript once and then only what is added: a few MB instead of about 2.5 GB.
  • A leaner background host. It now runs with memory settings tuned for a process that mostly waits, and Settings gives memory back when you close it.
  • Start, Stop and Restart answer you. Clicking one shows what it is doing ("Stopping Deckhand…"), then what happened ("Restarted."), or says so if nothing changed within 20 seconds. Before, nothing on screen moved.
  • The USAGE tab's token counts are Claude's own. The 5-hour and 7-day cards are Claude's quota, so their token counts no longer include Codex. The FABLE line counts Claude Fable models only (a local model with "Fable" in its name was being counted), and the weekly count is always the current week.

Install (new users)

  1. Download Deckhand-0.1.5.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Still not verified

The new memory figures on a long-running copy of this release (they were measured on the code, not yet on the installed app); the USAGE tab with Codex and Antigravity both reporting, on the display itself; anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall.

Feedback and bug reports: Issues.

Deckhand 0.1.4 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 13 Nov 10:29

Fifth alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No new firmware is needed for this release.

What's new

  • Far less memory. The background host (Deckhand Host in Activity Monitor) measured 327 MB after a day of running. Most of that was one cache: opening the PROJECTS tab kept a copy of the first prompt of every project you have ever used, about 100 MB on a Mac with 800 projects, until the host restarted. It now keeps only what it needs (measured: 108 MB down to 0.2 MB).
  • Steadier over long runs. Bluetooth devices nearby (phones change their address every few minutes) were remembered forever; the host now forgets the ones it could never connect to. It also stops re-reading Codex logs and session transcripts every five seconds when they have not changed.
  • Release notes in the update window. Sparkle's update window now shows what changed, starting with this update. Before, it was empty and the notes were only on the GitHub page.

Install (new users)

  1. Download Deckhand-0.1.4.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Still not verified

The host's memory over a full day on this release (the fix was measured on the code path that caused it, not yet on a long-running host); the USAGE tab with Codex and Antigravity both reporting, on the display itself; anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall.

Feedback and bug reports: Issues.

Deckhand 0.1.3 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 12 Nov 05:27

Fourth alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). The display needs new firmware to show Antigravity sessions and usage; an older display keeps working and simply does not show them.

What's new

  • Antigravity, everywhere. Google has retired Gemini CLI in favour of Antigravity CLI (agy), and Deckhand now calls it Antigravity throughout: the menu bar's AG column (it was GM) and its Antigravity section.
  • Antigravity sessions on the display. They appear beside Claude Code and Codex, tagged AGY with their own animated mark, showing working or ready, the model and your latest prompt.
  • An Antigravity hook. Settings › Hooks › Antigravity hook (on by default when Antigravity is installed). It adds the model and the latest prompt to Antigravity sessions. It never answers or holds up a tool call: Antigravity has no hook that runs while its approval prompt is on screen, so those prompts are still answered in Antigravity.
  • Antigravity usage without the app. With only agy in a terminal, Deckhand now reads usage from the CLI itself (no model turn, so it costs no quota). The figure shown is your most-used Gemini limit, so if you mostly use Argon, you see Argon's.
  • Antigravity usage on the display. A new AGY strip on the USAGE tab. When Codex is reporting too, the tab makes room for both strips.
  • A smaller download. About 35 MB instead of 52 MB, and about 119 MB installed instead of 155 MB.

Install (new users)

  1. Download Deckhand-0.1.3.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Still not verified

The USAGE tab with Codex and Antigravity both reporting, on the display itself (it is checked offline only); anything new on the smaller (2.8") display; a Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; and Uninstall. Antigravity's usage and session data come from interfaces Google does not document and can change in an update.

Feedback and bug reports: Issues.

Deckhand 0.1.2 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 12 Nov 03:13

Third alpha of Deckhand.app. Installed 0.1.x copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh).

What's fixed

  • "Open Deckhand at login" now sticks. After a restart the background host came back but the menu-bar icon did not, because the app's login item was switched off. Two causes are fixed:

    • The switch in Settings › General snapped back for up to 15 seconds after you flipped it, so it looked like the click had not worked. It now shows the real state straight away.
    • The first-run setup could finish without making Deckhand a login item, when the background host was already set up from an earlier install. Setup now turns it on as it finishes. It does this on the first run only, so switching it off later is respected.

    If you are updating: check Settings › General › Open Deckhand at login once. If it is off, switch it on. The update does not change that setting for you.

Install (new users)

  1. Download Deckhand-0.1.2.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Still not verified

A Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; Uninstall; Gemini usage, which reads an undocumented local interface of the Gemini app; and the setup fix itself, which only runs on a first install.

Feedback and bug reports: Issues.

Deckhand 0.1.1 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 09 Nov 07:16

Second alpha of Deckhand.app. Installed 0.1.0 copies update to this automatically (Sparkle); new installs download the DMG below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh).

What's new

  • A proper install window. Opening the DMG now shows Deckhand and the Applications folder with an arrow between them, a picture of the menu bar Deckhand will live in, and the version — instead of a bare folder. The mounted disk carries Deckhand's icon.
  • Hangs explain themselves. If the background host's work loop ever stalls, its log now names the exact step it is stuck in and for how long, so a rare hang seen on the development Mac can be tracked down the next time it happens. No change in behaviour otherwise.

Install (new users)

  1. Download Deckhand-0.1.1.dmg, open it, and drag Deckhand onto Applications.
  2. Open it from Applications and follow the setup window (it asks before touching Claude Code's settings and backs up first).
  3. Restart Claude Code so it picks up the hooks.

Still not verified

A Mac with no Node or Homebrew installed; a notched MacBook screen's menu bar; a first-time Bluetooth prompt from a fresh permission state; Uninstall; and Gemini usage, which reads an undocumented local interface of the Gemini app.

Feedback and bug reports: Issues.

Deckhand 0.1.0 (alpha)

Pre-release

Choose a tag to compare

@blueandhack blueandhack released this 08 Nov 08:09

First alpha of Deckhand.app — the Mac side of Deckhand, the desk display for Claude Code, packaged as one notarized app. It is an alpha: it has been tested end to end on one Mac, and the list of what has not been verified is below.

Requires: Apple Silicon, macOS 14 or later, and a Deckhand display (firmware is flashed from the repo with ./flash.sh). No Node, Homebrew or clone of the repo is needed for the app itself.

Install

  1. Download Deckhand-0.1.0.dmg below, open it, and drag Deckhand to Applications.
  2. Open it from Applications. The setup window:
    • offers to stop a Deckhand already running from the repo (its launch agent is moved to ~/Deckhand-backups, not deleted);
    • lists every change it will make to Claude Code's settings and asks first, backing up before it writes;
    • asks macOS for Bluetooth once (refuse it and USB still works), then runs the host in the background, starting at login.
  3. Restart Claude Code so it picks up the hooks.

What's in it

  • Menu bar: Claude, Codex and Gemini usage as two-row columns (5-hour over weekly), session counts and a needs-input badge, in four sizes plus Automatic, which shrinks the item when the menu bar runs out of room (MacBook notch).
  • Dropdown: connection, usage per service with reset times, and every session with its state.
  • Settings window: General, Menu Bar, Devices (pairing, which display Bluetooth follows, this Mac's name and icon), Claude Code (hooks, Codex hooks switch), About (updates, host log, setup, uninstall).
  • Its own Node and host, run by launchd and restarted if it crashes or hangs.
  • Updates itself with Sparkle.

Not verified yet

  • A Mac with no Node or Homebrew installed (the build checks that nothing links outside the app, which stands in for it).
  • A notched MacBook screen's menu bar (the shrink-to-fit logic was tested by forcing an overflow on an external display).
  • A first-time Bluetooth prompt raised from a fresh macOS permission state.
  • Uninstall (Settings › About).
  • Gemini usage reads an undocumented local interface of the Gemini app; a Gemini update may make it disappear (nothing breaks).

Feedback and bug reports: Issues.