Release 0.3.1

.github/workflows/release-assets.yml

@@ -54,6 +54,7 @@ jobs:
       - name: Run headless app smoke
         run: |
           TASKERS_TERMINAL_BACKEND=mock \
+          TIMEOUT_SECONDS=90 \
             bash scripts/headless-smoke.sh \
             ./target/debug/taskers-gtk \
             --smoke-script baseline \
@@ -63,14 +64,19 @@ jobs:
       - name: Build Linux bundle
         run: bash scripts/build_linux_bundle.sh
 
+      - name: Build Ghostty runtime bundle
+        run: bash scripts/build_ghostty_runtime_bundle.sh
+
       - name: Run launcher smoke
-        run: bash scripts/smoke_linux_release_launcher.sh
+        run: TIMEOUT_SECONDS=90 bash scripts/smoke_linux_release_launcher.sh
 
-      - name: Upload Linux bundle
+      - name: Upload release assets
         uses: actions/upload-artifact@v4
         with:
-          name: linux-bundle
-          path: dist/taskers-linux-bundle-v*.tar.xz
+          name: release-assets
+          path: |
+            dist/taskers-linux-bundle-v*.tar.xz
+            dist/taskers-ghostty-runtime-v*.tar.xz
 
   release-manifest:
     needs:
@@ -124,6 +130,7 @@ jobs:
             echo 'files<<EOF'
             echo 'dist/release/taskers-manifest-v*.json'
             echo 'dist/release/taskers-linux-bundle-v*.tar.xz'
+            echo 'dist/release/taskers-ghostty-runtime-v*.tar.xz'
             echo 'EOF'
           } >> "$GITHUB_OUTPUT"
 

Cargo.toml

@@ -20,7 +20,7 @@ edition = "2024"
 homepage = "https://github.com/OneNoted/taskers"
 license = "MIT OR Apache-2.0"
 repository = "https://github.com/OneNoted/taskers"
-version = "0.3.0"
+version = "0.3.1"
 
 [workspace.dependencies]
 adw = { package = "libadwaita", version = "0.9.1" }
@@ -47,12 +47,12 @@ ureq = "2.12"
 uuid = { version = "1.22.0", features = ["serde", "v7"] }
 webkit6 = { version = "0.6.1", features = ["v2_50"] }
 xz2 = "0.1"
-taskers-core = { version = "0.3.0", path = "crates/taskers-core" }
-taskers-control = { version = "0.3.0", path = "crates/taskers-control" }
-taskers-domain = { version = "0.3.0", path = "crates/taskers-domain" }
-taskers-ghostty = { version = "0.3.0", path = "crates/taskers-ghostty" }
-taskers-host = { version = "0.3.0", path = "crates/taskers-host" }
-taskers-paths = { version = "0.3.0", path = "crates/taskers-paths" }
-taskers-runtime = { version = "0.3.0", path = "crates/taskers-runtime" }
-taskers-shell = { version = "0.3.0", path = "crates/taskers-shell" }
-taskers-shell-core = { version = "0.3.0", path = "crates/taskers-shell-core" }
+taskers-core = { version = "0.3.1", path = "crates/taskers-core" }
+taskers-control = { version = "0.3.1", path = "crates/taskers-control" }
+taskers-domain = { version = "0.3.1", path = "crates/taskers-domain" }
+taskers-ghostty = { version = "0.3.1", path = "crates/taskers-ghostty" }
+taskers-host = { version = "0.3.1", path = "crates/taskers-host" }
+taskers-paths = { version = "0.3.1", path = "crates/taskers-paths" }
+taskers-runtime = { version = "0.3.1", path = "crates/taskers-runtime" }
+taskers-shell = { version = "0.3.1", path = "crates/taskers-shell" }
+taskers-shell-core = { version = "0.3.1", path = "crates/taskers-shell-core" }

README.md

@@ -1,13 +1,24 @@
-# taskers
+# Taskers
 
-Taskers is a Linux-first terminal workspace for agent-heavy work. It provides
-Niri-style top-level windows, local pane splits, tabs inside panes, and an
-attention rail for active and completed work.
+Taskers is a Linux-first terminal workspace for agent-heavy work. It combines:
+
+- top-level workspace windows that behave like a tiling canvas
+- panes inside each window
+- tabs inside each pane
+- an attention rail for unread, waiting, error, and completed work
+- a local control CLI for notifications, agent state, browser automation, and debugging
 
 The active product lives at the repo root. Archived pre-cutover GTK/AppKit code
 is kept under `taskers-old/` for reference only.
 
-## Try it
+## Documentation
+
+- [Daily usage](docs/usage.md)
+- [Notifications and attention](docs/notifications.md)
+- [Taskersctl operator guide](docs/taskersctl.md)
+- [Release checklist](docs/release.md)
+
+## Install
 
 Linux (`x86_64-unknown-linux-gnu`):
 
@@ -16,12 +27,54 @@ cargo install taskers --locked
 taskers
 ```
 
-The first launch downloads the exact version-matched Linux bundle from the tagged
-GitHub release. The Linux app requires GTK4/libadwaita plus the host WebKitGTK
-6.0 runtime.
+The first launch downloads the exact version-matched Linux bundle from the
+tagged GitHub release. The Linux app requires GTK4/libadwaita plus the host
+WebKitGTK 6.0 runtime.
 
 Mainline macOS support is currently not shipped from this repo root.
 
+## First 5 Minutes
+
+Start Taskers:
+
+```bash
+taskers
+```
+
+Keep the workspace model straight:
+
+- A workspace contains top-level workspace windows.
+- A workspace window contains panes.
+- A pane contains tabs.
+- Scrolling/panning is a workspace-window concern. Splits and tabs stay local to the current window.
+
+Open a terminal in Taskers and emit a test notification:
+
+```bash
+taskersctl notify --title "Taskers" --body "Hello from the current pane"
+```
+
+You should see:
+
+- an unread badge in the sidebar
+- a notification row in the attention rail
+- a desktop banner unless the target is already visible and notification suppression is enabled
+
+Try the built-in shell helpers from a Taskers terminal:
+
+```bash
+taskers_waiting "Need review"
+taskers_done "Finished"
+taskers_error "Build failed"
+```
+
+Open a browser pane from the pane controls, then inspect it from the same Taskers terminal:
+
+```bash
+taskersctl browser snapshot
+taskersctl browser get title
+```
+
 ## Develop
 
 On Ubuntu 24.04, install the Linux UI dependencies first:
@@ -30,13 +83,14 @@ On Ubuntu 24.04, install the Linux UI dependencies first:
 sudo apt-get install -y libgtk-4-dev libadwaita-1-dev libjavascriptcoregtk-6.0-dev libwebkitgtk-6.0-dev xvfb
 ```
 
-Run the app directly:
+Install the app into Cargo's bin directory, then run it from there:
 
 ```bash
-cargo run -p taskers-gtk --bin taskers-gtk
+cargo install --path crates/taskers-app --force
+taskers-gtk
 ```
 
-Point the desktop launcher at the repo-local dev build:
+Point the desktop launcher at that Cargo-bin install:
 
 ```bash
 bash scripts/install-dev-desktop-entry.sh
@@ -47,10 +101,10 @@ Run the headless baseline smoke:
 ```bash
 TASKERS_TERMINAL_BACKEND=mock \
 bash scripts/headless-smoke.sh \
-  ./target/debug/taskers-gtk \
+  "$(command -v taskers-gtk)" \
   --smoke-script baseline \
   --diagnostic-log stderr \
   --quit-after-ms 5000
 ```
 
-Release checklist: [docs/release.md](docs/release.md)
+For publishing and release prep, use [docs/release.md](docs/release.md).

assets/taskers.desktop.in

@@ -8,5 +8,5 @@ Icon=taskers
 Terminal=false
 Categories=Development;
 StartupNotify=true
-StartupWMClass=taskers
+StartupWMClass=dev.taskers.app
 X-GNOME-UsesNotifications=true

crates/taskers-app/Cargo.toml

@@ -13,6 +13,10 @@ publish = false
 name = "taskers-gtk"
 path = "src/main.rs"
 
+[[bin]]
+name = "taskersctl"
+path = "src/bin/taskersctl.rs"
+
 [dependencies]
 adw.workspace = true
 anyhow.workspace = true
@@ -21,6 +25,8 @@ clap.workspace = true
 dioxus.workspace = true
 dioxus-liveview.workspace = true
 gtk.workspace = true
+serde.workspace = true
+serde_json.workspace = true
 taskers-control.workspace = true
 taskers-core.workspace = true
 taskers-domain.workspace = true
@@ -30,5 +36,6 @@ taskers-paths.workspace = true
 taskers-runtime.workspace = true
 taskers-shell.workspace = true
 taskers-shell-core.workspace = true
+time.workspace = true
 tokio.workspace = true
 webkit6.workspace = true

crates/taskers-app/assets/taskers-codex-notify.sh

@@ -0,0 +1,50 @@
+#!/bin/sh
+set -eu
+
+payload=${1-}
+message=
+taskers_ctl=${TASKERS_CTL_PATH:-}
+
+if [ -z "$taskers_ctl" ] && command -v taskersctl >/dev/null 2>&1; then
+  taskers_ctl=$(command -v taskersctl)
+fi
+
+if [ -n "$payload" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    message=$(
+      printf '%s' "$payload" \
+        | jq -r '."last-assistant-message" // .message // .title // empty' 2>/dev/null \
+        | head -c 160
+    )
+  fi
+fi
+
+if [ -z "$message" ]; then
+  message="Turn complete"
+fi
+
+has_embedded_surface_context() {
+  [ -x "${taskers_ctl:-}" ] || return 1
+  [ -n "${TASKERS_WORKSPACE_ID:-}" ] || return 1
+  [ -n "${TASKERS_PANE_ID:-}" ] || return 1
+  [ -n "${TASKERS_SURFACE_ID:-}" ] || return 1
+  [ -n "${TASKERS_TTY_NAME:-}" ] || return 1
+
+  current_tty=$(tty 2>/dev/null || true)
+  case "$current_tty" in
+    /dev/*) ;;
+    *) return 1 ;;
+  esac
+
+  [ "$current_tty" = "$TASKERS_TTY_NAME" ] || return 1
+}
+
+if has_embedded_surface_context; then
+  "$taskers_ctl" agent-hook stop \
+    --workspace "$TASKERS_WORKSPACE_ID" \
+    --pane "$TASKERS_PANE_ID" \
+    --surface "$TASKERS_SURFACE_ID" \
+    --agent codex \
+    --title Codex \
+    --message "$message" >/dev/null 2>&1 || true
+fi