Seshctl

Seshctl

A macOS session manager for terminal-based workflows. Tracks coding sessions across Terminal.app, iTerm2, VS Code, Cursor, Warp, Ghostty, and cmux, with a native menu bar app and CLI.


Requirements

• macOS 13+
• Optional: jq — used by the standalone seshctl-uninstall fallback for robust JSON edits

Install

1. Grab the latest `Seshctl-X.Y.Z.dmg` from the [releases page](https://github.com/julo15/seshctl/releases/latest).

2. Open the DMG and drag `Seshctl.app` to `/Applications`.

3. **First launch only** — Seshctl is self-signed (not yet notarized with an Apple Developer ID), so the first time you double-click it macOS will block it with *"Apple could not verify 'Seshctl' is free of malware"*. Unblock with one of:

   • System Settings → Privacy & Security, scroll to the bottom, click Open Anyway next to the "Seshctl was blocked" row, then re-launch Seshctl and confirm the second prompt.
   • Or run xattr -d com.apple.quarantine /Applications/Seshctl.app in Terminal, then double-click.

   After this once, future launches and Sparkle auto-updates are silent — macOS remembers the bypass per signing identity.

4. Grant Accessibility when prompted on first launch — the system permission window can open behind the active app, so Cmd+Tab if you don't see it.

The app auto-updates over Sparkle. You can also trigger a check from the menu-bar gear → **About** → **Check for Updates…**.

Migrating from 0.3.0

0.3.0 doesn't bundle the auto-updater, so the one-time transition to 0.4.0 is manual. From here on every release lands inside the app with a one-click **Install Update** prompt.

1. Quit Seshctl (menu-bar icon → Quit, or pkill -f SeshctlApp).
2. Download the latest DMG from the releases page.
3. Open the DMG and drag Seshctl.app over /Applications (replace the existing one).
4. Unblock the first launch —