feat: TaskYou Desktop — Tauri GUI with real executor terminal#583
Merged
Conversation
…plete, session bootstrap
Extends the HTTP API with everything a desktop GUI client needs:
- GET/PATCH /api/settings (secret-like keys excluded)
- attachment list/upload/download/delete endpoints
- GET /api/executors (availability + default)
- POST /api/autocomplete (ghost-text suggestions)
- GET /api/tasks/{id}/terminal-info + POST /api/tasks/{id}/session
- GET /api/tasks/latest-logs for board activity sub-lines
- PATCH /api/tasks/{id} accepts permission_mode and effort_level
- task JSON exposes port, worktree path, pane/window/session ids
The interactive session bootstrap is extracted from the TUI detail view
into executor.EnsureTaskWindow so the TUI and HTTP API share one
implementation; ty serve now constructs an executor to power it.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Native desktop port of the TUI built on Tauri 2 + React + xterm.js: - Kanban board with live SSE updates, keyboard parity, filtering, command palette, toasts + native notifications - Task detail with markdown, live execution log, dependencies, attachments, and a REAL terminal: a Rust PTY (portable-pty) running a tmux client attached to the task's daemon window via a grouped view session (destroy-unattached) — no pane moves, daemon survives, fully interactive (keys, mouse, resize) - New/edit task forms with ghost-text autocomplete, drag-drop attachments, executor/effort/permission controls - Project + task type CRUD, app connection settings - Sidecar supervisor: discovers the ty binary, health-checks the API, spawns ty serve / ty daemon when absent, cleans up owned children Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
QA fixes from end-to-end testing: - record task events in event_log on every mutation — the SSE board stream polls this table but nothing ever wrote it, so /api/board/stream (and /api/events) never fired; live updates now work across processes - API timestamps were local time with a Z suffix; format real UTC - prevent shortcut keys (n/p/f/e/r/S) from leaking into the inputs they open; new-task form defaults to the first task type from the API - set destroy-unattached during tmux attach (not before) to avoid the view session being GC'd pre-attach; add a real-tmux integration test covering attach → output stream → typed input echo → clean teardown Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Owner
Author
QA evidenceKanban board (live SSE updates — the Done card moved columns with no reload): Task detail — markdown body, dependencies, attachments, execution log: The real terminal in the desktop app — PTY tmux client attached to the task window (executor pane + shell pane). The Real All runs on an isolated stack (dedicated 🤖 Generated with Claude Code |
… drag-and-drop board Addresses 'feels like a web app crammed into a shell' feedback: - Styling migrated from hand-rolled CSS to Tailwind v4 + shadcn/ui (button/dialog/select/command/sonner/etc); palette is now cmdk, toasts are sonner with an Open action - Native shell: overlay titlebar with traffic-light inset + drag region, window vibrancy (UnderWindowBackground) behind a translucent theme, forced dark appearance, real menu bar (App/File/Edit/View/ Window) — standard Edit roles make ⌘C/⌘V/⌘Z work; New Task ⌘N, Settings ⌘,, Search ⌘P, Board ⌘1 route to the frontend - Arrow cursors on controls, no overscroll, system font stack - Kanban cards are draggable between columns (Agentation feedback): drop on In Progress executes, Done closes, Backlog/Blocked set status - Agentation feedback toolbar in dev builds, syncing to agentation-mcp on :4747; app icon generated from the TaskYou logo Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Owner
Author
UI overhaul — native feel + shadcn/uiFollow-up addressing the "web app crammed into a shell" feedback (and both Agentation annotations, now resolved):
🤖 Generated with Claude Code |
…, modal fixes Design pass from Agentation feedback + 'more modern and delightful': - Full light + dark mode: system-following with a titlebar toggle (system → light → dark), themed window chrome, light/dark xterm palettes that switch live, themed toasts - Opaque dialog/popover surfaces (annotation: 'transparent modal, super hard to read') — vibrancy translucency now applies only to the app shell, never to overlays - Settings project/type editors open in proper modals (annotation) - Motion: FLIP layout animations as cards move between kanban columns, enter/exit transitions, animated view switches — all 140-220ms ease-out - Optimistic status updates: drag/execute/close/archive reflect instantly, server refresh reconciles; task cards memoized - React 19 (latest shadcn targets ref-as-prop; fixes broken title autofocus + ghost-text ref on React 18), Radix-correct dialog autofocus via onOpenAutoFocus - Semantic surface tokens replace hard-coded white/[…] overlays so both themes render correctly Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Owner
Author
Design pass: light/dark mode, motion, optimistic boardBoth new Agentation annotations resolved (opaque modals; settings editors in dialogs), plus:
Light (system-following): Dark: Opaque modal (was translucent and unreadable):
🤖 Generated with Claude Code |
Agentation feedback: 'this filter thing should work just like the TUI version'. The filter bar now mirrors the TUI exactly: - typing an unclosed [ opens a fuzzy project dropdown (colors + task counts); ↑/↓ navigate, Tab/Enter insert the [project] chip - Enter applies the filter and returns keyboard control to the board; the bar stays visible while a filter is active - Esc clears (also from board level), Backspace on empty closes, Backspace after ] deletes the whole [project] chip Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Per-column render cap (50) with a '+N more' expander — the Done column alone was rendering 663 animated cards (824 total); the board now renders at most ~130, and keyboard selection auto-expands past the cap (TUI hidden-done parity) - Field-level memo equality on cards: API refreshes return fresh objects, so reference-based memo re-rendered the whole board on every SSE tick; cards now re-render only when their content actually changes - Narrow store subscriptions (useAppSelector) so selection changes don't fan out through the whole tree - View switches swap immediately with a 90ms fade-in — the exit-then- enter transition read as sluggish; dialog/select animations at 120ms - Card hover transitions limited to paint-only properties Measured: ~15ms per keyboard selection move (single frame) on a 300-visible-task board in dev mode. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
'Waiting for executor to start' showed even though the executor was
running. Cause: the TUI's detail view join-panes the executor pane into
its own session, destroying the daemon window — the GUI's window-name
scan found nothing and concluded the executor never started.
- terminal-info now falls back to locating the stored pane ID anywhere
on the tmux server (pane IDs survive join-pane moves) and reports
pane_borrowed_by when it lives outside a daemon window
- the GUI shows the truth ('attached to the TUI, will appear here when
released') and auto-attaches once the TUI gives the pane back
- ensure-session returns 409 while borrowed instead of spawning a
duplicate executor session
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
In-app toasts cover the focused case; system notifications now only fire when the user is in another app (native etiquette). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Conflicts: internal/web/server.go (union of Sessions/autocomplete and browser-relay fields) and internal/web/handlers.go (both sides added port/worktree_path/has_executor to task JSON with matching names; kept the GUI's additional pane/session fields). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… and desktop
ty-web is superseded: ty serve now hosts the same React app the Tauri
shell renders, embedded into the binary behind a 'ui' build tag.
- internal/web/ui embeds desktop/dist (make build-ui stages it; the
Makefile adds -tags ui automatically when present); plain go build
stays Node-free and serves a pointer page at /
- SPA fallback for client routes; /api/* keeps precedence
- API base auto-detects same-origin when served by ty itself
- Browser terminal fallback: without a Tauri PTY, the terminal pane
attaches xterm.js to the existing /api/tasks/{id}/terminal WebSocket
(capture-pane mirror + send-keys input). It addresses panes by ID, so
it works even while the TUI has the pane borrowed
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…-gui Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… README downloads The desktop app no longer requires a ty install: a UI-embedded ty is bundled as a Tauri sidecar (externalBin) and the supervisor prefers it (config override → sidecar → PATH → known paths). Download → open → works; tmux and an executor CLI remain machine prerequisites. - make desktop-bundle stages the sidecar for the host triple and builds the platform bundles - .github/workflows/desktop.yml builds macOS (arm64 + x64 dmg) and Linux (AppImage + deb) on v* tags and attaches them to the GitHub release next to the goreleaser binaries (workflow_dispatch uploads artifacts for testing); no Windows — execution runs on tmux - transparent window + vibrancy moved to tauri.macos.conf.json so Linux gets an opaque window; html keeps an opaque themed background except in the macOS shell - README 'Desktop App' section: where to download, prerequisites, unsigned-app first-launch note Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…aunches Two fixes that make the downloaded bundle actually work on a clean Mac: - Finder-launched apps get a minimal PATH (no /opt/homebrew/bin, no user bins), so the bundled ty couldn't find tmux or executors even when installed. The app now loads the login shell's PATH at startup before anything resolves binaries. - First-run gate: before booting, the app probes for tmux and the known executor CLIs (claude, codex, gemini, opencode, pi, openclaw). If either is missing it shows a setup checklist with copyable install commands, Re-check, and Continue anyway — instead of failing mysteriously at execution time. Also: make desktop-sidecar target (cargo check/test in src-tauri need a staged sidecar since externalBin landed). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
TaskYou Desktop — native GUI port (Tauri 2) with a real executor terminal
Ports the TUI feature set into a desktop GUI under
desktop/, built on Tauri 2 + React + xterm.js, reusing the existing daemon/CLI/HTTP stack as the single source of truth.The terminal (the hard requirement)
The executor pane is a real terminal, not a capture-pane mirror:
portable-pty, wezterm's PTY layer), streaming over Tauri Channels.task-{id}window. Grouped sessions share windows but keep independent focus, so the GUI, the TUI, and the daemon coexist without moving panes (join-panestays TUI-only). The view session is destroyed on detach; the daemon window survives.mouse on), and resize all flow through. You see the executor pane and shell pane exactly as the daemon laid them out.desktop/src-tauri/tests/terminal_attach.rsproves the path end-to-end against a scratch tmux server: window content streams to the PTY, typed input echoes back through the executor window, resize works, teardown kills the view session and leaves the daemon session intact.Go API extensions (
internal/web)GET/PATCH /api/settings(credential-like keys excluded);GET /api/executors;POST /api/autocomplete(ghost text);GET /api/tasks/latest-logs(board sub-lines);PATCH /api/tasks/{id}now acceptspermission_mode/effort_level; task JSON exposes port/worktree/pane/window/session fields.GET /api/tasks/{id}/terminal-info+POST /api/tasks/{id}/session: interactive-session bootstrap, extracted from the TUI detail view intoexecutor.EnsureTaskWindowso TUI and API share one implementation (no more command-builder divergence).ty serveconstructs an executor to power it.Upstream bugs found & fixed along the way
/api/board/streamnever fired: it pollsevent_log, but nothing ever wrote that table. Task mutations now record events in the db layer, so SSE live updates work across processes (also un-deadens/api/events).Zsuffix — now real UTC (RFC3339).GUI feature set
Kanban board (live SSE updates, keyboard parity with the TUI, filter bar with
#id/[project]/text, column collapse, command palette, toasts + native notifications) · task detail (markdown, live execution log, dependencies with add/remove, attachments with drag-drop, PR/editor/branch links, executor switcher, permission badges) · new/edit forms (ghost-text autocomplete, attachments, executor/effort/permission, execute-immediately) · retry-with-feedback, status, confirm dialogs, help overlay · project + task-type CRUD, connection settings · sidecar supervisor (discoversty, health-checks the API, spawnsty serve/ty daemonwhen missing, kills only what it spawned).Verification
go vet, full-racesuite, golangci-lint v2.8.0 (CI's pin) — 0 issuestsc+ production buildWORKTREE_DB_PATH+ scratchTMUX_TMPDIR): board live-updates via SSE, task created through the form, palette/filter/keyboard flows, and the desktop app attaching its terminal to (1) a synthetic executor window with typed input echoing back through tmux, and (2) a realclaudesession bootstrapped viaPOST /api/tasks/{id}/session— Claude Code's UI rendering live in the GUI terminal next to the shell pane. Screenshot evidence captured locally (/tmp/ty-tauri-qa-shots/); publishing to the QA bucket needs your sign-off.Notes / known limits
tauri dev/pnpm tauri buildfromdesktop/(pnpm + rustup toolchain). Bundle target: macOS.app.kill_allsweep — harmless, dev-only.🤖 Generated with Claude Code