Skip to content

Session Kit v0.1.0 (Public Beta)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@dob323 dob323 released this 03 Aug 10:53
· 42 commits to main since this release
v0.1.0
64414ac

Session Kit v0.1.0

This is the first public beta of Session Kit for Linux with systemd and macOS
14 or newer.

Session Kit keeps shpool terminals available across SSH disconnects and provider
exits. Its picker shows Claude Code, Codex, and shell sessions with stable
numbers, task names, colors, reply state, and exact local identity checks.

Highlights

  • On-demand SSH picker with guarded open, move, close, repair, recovery, resume,
    and fork actions.
  • Native Linux and macOS process identity with changed-generation refusal.
  • Exact Claude Code and Codex conversation binding.
  • Per-user systemd and launchd lifecycle commands.
  • Immutable local releases with update and rollback that do not restart shpool.
  • Optional terminal journals, off by default.
  • Report-only watchdog by default. Automated watchdog repair remains Linux-only.
  • No account, hosted service, analytics, update beacon, or telemetry.

Release evidence

  • The local release gate passed 391 tests plus ShellCheck, Ruff, formatting,
    Python compilation, mypy, documentation links, privacy scanning, exact public
    export, checksum verification, and two byte-identical artifact builds.
  • Real-device acceptance passed on macOS 26.5.1 build 25F80 on Apple Silicon
    with Bash 5.3.15, Python 3.14.6, shpool 0.11.0, Claude Code 2.1.220, and Codex
    0.146.0. It covered launchd enable and safe-disable refusal, SSH detach and
    reconnect, exact Claude and Codex identity, naming, colors, provider exit,
    journals on and off, reaper, prune, report-only watchdog, update, rollback,
    and final update without restarting shpool.
  • GitHub CI covers Ubuntu 22.04 and 24.04 with Python 3.10 through 3.13, plus
    native macOS 15 Apple Silicon and Intel runners. Intel coverage is native CI,
    not real-provider device acceptance for this beta.

macOS services require the same user to be logged into the Mac desktop so the
per-user GUI LaunchAgent domain exists. A privileged or pre-login LaunchDaemon
is not included.

Install

Download the archive, checksum, and provenance files below. Verify the checksum,
then follow the README. The archive is generated from private source commit
f90dfb917e32b038c795fcee2b04be050abdeb8e; the public release commit is
6acebd72cbba5ed1f6aba200bbb90a3c11e40368.

Stable v1.0.0 is not part of this publication. It can be considered after the
seven-day beta evidence gate completes with no safety, data-loss, install,
update, or rollback blocker.

Assets 5
Loading