taskyou

Task You

A personal task management system with background task execution via pluggable AI agents (Claude Code, OpenAI Codex, Gemini, Pi, OpenClaw, or OpenCode). Tasks live in SQLite, run in isolated git worktrees, and are tracked on a Kanban board.

One engine — ty — three interfaces:

Interface	What it is
TUI	The first-class interface. The full experience in your terminal: Kanban board, task detail with live executor panes, forms, fuzzy search. Just run ty.
CLI	100% of TaskYou is scriptable. Every TUI action has a command, so scripts and AI agents can drive your entire queue.
GUI	A desktop app for macOS and Linux — and the same UI in your browser via ty serve.

The TUI — first class

The terminal UI is TaskYou's primary interface — everything ships here first. Launch it with ty.

Kanban Board

The main view showing tasks organized across Backlog, In Progress, Blocked, and Done columns

Task Detail View

Viewing a task with Claude's output and shell access in split panes

Execution Log

Live execution log showing task progress, worktree creation, and Claude's actions

New Task Form

Creating a new task with project selection, type, scheduling, and attachments

The CLI

Everything the TUI can do, the CLI can do too — create, execute, retry, and inspect tasks, read executor output, even send keystrokes to a running executor. That makes TaskYou trivial to drive from scripts, cron jobs, and AI agents.

Creating a task and checking the board without leaving your shell

See Full CLI Scriptability for the complete command surface.

The GUI

The same Kanban board in the desktop app or any browser

Just want the GUI? On macOS, install it with one command:

curl -fsSL taskyou.dev/install-macos.sh | bash

This downloads the latest DMG, verifies it, installs TaskYou.app to ~/Applications, and launches it — no Gatekeeper prompts, no sudo. Set TASKYOU_INSTALL_SYSTEM=1 to install to /Applications for all users instead.

Or grab a prebuilt bundle from the latest release:

• macOS: TaskYou-macos-arm64.dmg (Apple Silicon only)
• Linux: TaskYou-linux-x64.AppImage or .deb

The app is self-contained — it ships its own ty engine and starts the server and daemon for you. Two things must be installed on your machine: tmux (brew install tmux) and at least one executor CLI (e.g. Claude Code).

The macOS bundles are ad-hoc signed but not notarized, so macOS flags DMGs downloaded in a browser on first launch (the install script above avoids this entirely). If you installed from a browser-downloaded DMG, drag TaskYou.app to Applications, then either right-click it → Open → Open, or clear the download quarantine flag:

xattr -dr com.apple.quarantine /Applications/TaskYou.app

The same UI is also served in your browser at http://localhost:8484 whenever ty serve runs with the embedded UI (make build-ui build). Desktop gets a real PTY executor terminal; the browser falls back to a live terminal mirror. Source lives in desktop/.

Features