Handoff 0.2.0

Handoff 0.2.0 release notes

Release target: v0.2.0 from the reviewed main commit.

Handoff 0.2.0 renames the plugin identifier from org.omarchyforge.handoff to
omaforge.handoff. This is a breaking identity change and the only change in
this release. Local-first scope, runtime behavior, and the version-1
persisted-data format are unchanged.

Included

• Set the manifest id to omaforge.handoff.
• Update the panel moduleName and ipcTarget to the new identifier.
• Update the demo harness shell invocations to the new identifier.
• Update the manifest identity assertion in the plugin checks.
• Update the documented update and removal commands.

Upgrading

An installation of 0.1.2 or earlier is registered under the previous
identifier and is not migrated automatically:

omarchy plugin remove org.omarchyforge.handoff
omarchy plugin add omaforge.handoff

The bar widget must be placed again after reinstalling.

Saved projects and notes are preserved. State remains at
$XDG_DATA_HOME/omarchy-handoff/state.json in the version-1 format, which has
never been keyed to the plugin identifier. Removing the previous installation
does not delete that file.

Privacy and security

Handoff remains local-first. It has no server, account, API key, telemetry,
analytics, or required network access. This release does not change process
invocations, project inspection, persistence, or the version-1 data format.

Compatibility and verification

The candidate targets Omarchy 4 manifest schema 1. Official plugin validation,
Forge checks, and repository whitespace checks pass. Because the identifier is
the shell IPC target, the live install, visual, remove, and restore procedure
must be repeated before publication.

Handoff v0.1.2

Handoff 0.1.2 release notes

Release target: v0.1.2 from the reviewed main commit.

Handoff 0.1.2 refreshes the plugin interface while preserving its local-first
scope and version-1 persisted-data format.

Included

• Add the Omaforge app icon and branded Handoff header.
• Clarify pinned-project, project-detail, note, and action sections.
• Improve clean, dirty, branch, selection, and local-only status treatments.
• Add a scrollable panel layout for constrained displays.
• Add Ctrl+S note saving and an in-panel 500-character note limit and counter.
• Align the title at a fixed four-unit margin beside the logo.
• Add owner-project catalog metadata and public repository installation docs.

Privacy and security

Handoff remains local-first. It has no server, account, API key, telemetry,
analytics, or required network access. This release does not change process
invocations, project inspection, persistence, or the version-1 data format.

Compatibility and verification

The candidate targets Omarchy 4 manifest schema 1. Official plugin validation,
Forge checks, isolated ready/empty/error runtime states, QML formatting, and
repository whitespace checks pass. The refreshed ready-state preview contains
fictional project data only.

Handoff v0.1.1

Handoff 0.1.1 release notes

Release target: v0.1.1 from the reviewed private main commit.

Handoff 0.1.1 is a development-tooling maintenance release with no change to
the plugin's user-facing product scope or persisted-data format.

Included

• Adopt the Forge v0.2.0 isolated Quickshell runtime harness.
• Exercise fictional ready, empty, and error states without installation or
  saved-data writes.
• Declare the panel-only Qt Quick screenshot target used by Forge capture.
• Support fresh isolated reruns through omaforge dev --watch.
• Pin private CI to the public Forge v0.2.0 Action and CLI release.

Privacy and security

Handoff remains local-first and private. It has no server, account, API key,
telemetry, analytics, or required network access. Runtime development commands
require explicit trust, use temporary HOME/XDG paths, and do not connect to the
live Omarchy Shell. Screenshot capture renders only the declared panel item and
cannot capture the desktop.

Compatibility and verification

The candidate targets Omarchy 4 manifest schema 1. Official validation and
Forge checks passed. Ready, empty, and error states and a panel-only screenshot
passed in the isolated Quickshell runtime. Private CI passed with Forge
v0.2.0.

The repository remains private. This release does not submit Handoff to a
marketplace, announce it publicly, or authorize ongoing installation.

Handoff v0.1.0

Handoff 0.1.0 release notes

Release target: v0.1.0 from the reviewed main commit.

Handoff 0.1.0 is the first local-first project handoff widget for Omarchy 4.

Highlights

• Pin reviewed local Git projects from the native Omarchy bar panel.
• Save one focused next-step note per project.
• See branch, clean/dirty state, latest commit subject, and timestamps.
• Open the selected project in the configured terminal.
• Keep all Handoff state in an atomically written XDG-local JSON file.
• Exercise ready, empty, and error UI states with fictional in-memory demos.

Privacy and security

• No account, server, API key, telemetry, analytics, or required network access.
• Project paths are passed as discrete process arguments, never interpolated
  into a shell command.
• Git hooks and filesystem monitors are disabled during metadata inspection.
• Handoff does not execute project builds, scripts, hooks, or QML.
• The state file may contain sensitive paths and notes; it is never uploaded by
  Handoff.

Compatibility

The candidate targets Omarchy 4, manifest schema 1, and the verified
bar-widget contract. It requires Git and xdg-terminal-exec.

Verification evidence

• Official omarchy plugin validate passed.
• Omarchy Forge reported no findings.
• Private GitHub CI passed.
• Isolated Quickshell first-run, persistence, Git metadata, and opened-panel
  harnesses passed.
• A hostile-fixture test configured an external Git filesystem monitor;
  Handoff read the project metadata without executing that program.
• A controlled live Omarchy 4 session verified ready, empty, error, refresh,
  close, and cleanup behavior.
• The live installation was removed, its test data deleted, shell.json
  restored byte-for-byte, and shell health confirmed afterward.

Known limits

• Projects are pinned by path; Handoff does not scan the filesystem.
• There is one current note per project, with no history or synchronization.
• Handoff opens a terminal but does not launch an editor or coding agent.
• Version 0.1.0 has not been submitted to an Omarchy marketplace.