v0.4.0

SESS v0.4.0

SESS v0.4.0 adds the first user-facing analytics commands.

Instead of treating session data as something buried in SQLite, you can now inspect recent work directly from the CLI, either for the current repository or across every tracked project on your machine.

Highlights

• sess history shows recent sessions, including paused, active, and ended work.
• sess stats shows totals, averages, longest-session data, and PR counts.
• sess report gives you a compact summary with both aggregate metrics and recent sessions.
• --all support on history, stats, and report lets you view cross-project activity without changing directories.

Example commands

sess history
sess history --all --limit 10
sess stats
sess stats --all
sess report
sess report --all

Installation

Quick install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.4.0/install.sh | sudo bash

By default this installs sess to /usr/local/bin/sess.

To install into /usr/bin instead:

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.4.0/install.sh | sudo env SESS_INSTALL_DIR=/usr/bin bash

Manual install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.4.0/sess-linux-amd64.tar.gz | tar xz
sudo install -m 0755 sess /usr/local/bin/sess

Verify

sess --version

Expected output:

SESS v0.4.0

v0.3.1

Installation

Quick Install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.1/install.sh | sudo bash

By default this installs sess to /usr/local/bin/sess.

To install into /usr/bin instead:

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.1/install.sh | sudo env SESS_INSTALL_DIR=/usr/bin bash

Manual Install

Linux/macOS archive contents extract to a binary named sess, not a platform-named file.

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.1/sess-linux-amd64.tar.gz | tar xz
sudo install -m 0755 sess /usr/local/bin/sess

Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.1/sess-windows-amd64.zip" -OutFile "sess.zip"
Expand-Archive sess.zip -DestinationPath .
# Move sess.exe to a directory in your PATH

Patch Summary

v0.3.1 fixes sess start in repositories whose default branch is not dev.

• SESS now detects the repository's real base branch from origin/HEAD and falls back to the current branch when needed.
• New projects now store the detected base branch instead of assuming dev.
• Existing tracked projects with a stale dev base branch are repaired automatically when the repo actually uses main or master.
• sess start validates that the tracked base branch exists before checkout and pull, which prevents the broken start flow that affected main/master repositories.
• The patch includes coverage for master-default repositories to lock the behavior in.

Verify Installation

sess --version

Full Changelog: v0.3.0...v0.3.1

v0.3.0

Installation

Quick Install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.0/install.sh | sudo bash

By default this installs sess to /usr/local/bin/sess.

To install into /usr/bin instead:

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.0/install.sh | sudo env SESS_INSTALL_DIR=/usr/bin bash

Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.0/sess-windows-amd64.zip" -OutFile "sess.zip"
Expand-Archive sess.zip -DestinationPath .
Move-Item .\sess.exe "$env:USERPROFILE\bin\sess.exe"
# Add $env:USERPROFILE\bin to PATH if it is not already there

Verify Installation

sess --version

Highlights

v0.3.0 completes the core session lifecycle.

This release adds sess end, so a session can now be carried all the way from branch creation to pull request handoff inside the CLI.

What that means in practice:

• end an active or paused session with sess end
• commit dirty work during the end flow with a prompted commit message
• rebase onto the tracked base branch before handoff
• push the session branch and create or reuse a PR through gh
• switch back to the base branch before the session is marked ended
• store PR number and PR URL in session history
• keep the session open if checkout, rebase, push, or PR creation fails

Also Included

• improved tests around session lifecycle, persistence, version handling, and TUI helper logic
• refreshed project docs and a new user-facing documentation set
• release/install docs aligned with the current command surface

Notes

The main follow-up after v0.3.0 is conflict and interrupted-workflow recovery for sess end when rebase or push steps fail mid-flow.

Manual Install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.3.0/sess-linux-amd64.tar.gz | tar xz
sudo install -m 0755 sess /usr/local/bin/sess

Full Changelog: v0.2.2...v0.3.0

v0.2.2

Installation

Quick Install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.2/install.sh | sudo bash

By default this installs sess to /usr/local/bin/sess.

To install into /usr/bin instead:

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.2/install.sh | sudo env SESS_INSTALL_DIR=/usr/bin bash

To verify the install:

sess --version

Highlights

• Added a release installer script for one-line Linux/macOS installs
• Fixed sess resume so it fails closed if branch checkout fails
• Fixed sess start to respect the tracked project base branch instead of hardcoding dev
• Fixed sess start to reject non-git directories before tracking them
• Fixed dirty-repo discard behavior so untracked files are actually removed
• Fixed GitHub issue integration to use human issue numbers
• Surfaced git stderr output during the start workflow
• Cleaned up CLI output and removed root command scaffolding leftovers
• Improved version formatting for Go pseudo-versions
• Added focused tests for session lifecycle, DB behavior, and version formatting

Manual Install

curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.2/sess-linux-amd64.tar.gz | tar xz
sudo install -m 0755 sess /usr/local/bin/sess

v0.2.1

Installation

Linux (amd64)

curl -L https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.1/sess-linux-amd64.tar.gz | tar xz
sudo mv sess-linux-amd64 /usr/local/bin/sess

macOS (Apple Silicon)

curl -L https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.1/sess-darwin-arm64.tar.gz | tar xz
sudo mv sess-darwin-arm64 /usr/local/bin/sess

macOS (Intel)

curl -L https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.1/sess-darwin-amd64.tar.gz | tar xz
sudo mv sess-darwin-amd64 /usr/local/bin/sess

Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.1/sess-windows-amd64.zip" -OutFile "sess.zip"
Expand-Archive sess.zip -DestinationPath .
# Move sess-windows-amd64.exe to a directory in your PATH

What's Changed

See the full changelog below.

Verify Installation

sess --version

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Installation

Linux (amd64)

curl -L https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.0/sess-linux-amd64.tar.gz | tar xz
sudo mv sess-linux-amd64 /usr/local/bin/sess

macOS (Apple Silicon)

curl -L https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.0/sess-darwin-arm64.tar.gz | tar xz
sudo mv sess-darwin-arm64 /usr/local/bin/sess

macOS (Intel)

curl -L https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.0/sess-darwin-amd64.tar.gz | tar xz
sudo mv sess-darwin-amd64 /usr/local/bin/sess

Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.2.0/sess-windows-amd64.zip" -OutFile "sess.zip"
Expand-Archive sess.zip -DestinationPath .
# Move sess-windows-amd64.exe to a directory in your PATH

What's Changed

See the full changelog below.

Verify Installation

sess --version

Full Changelog: https://github.com/Orctatech-Engineering-Team/sess-cli/commits/v0.2.0