ELYTerminal/TASKS.md

Tasks

Progress truth. Top to bottom, one at a time. A task is ticked only after its codex review passes; rounds go in tasks/reviews.md, three at most.

2. Foundation

• T01 Repo, crate, window: git, .gitignore, Cargo.toml with Ely pinned, main.rs opens one window through Ely, logging, scripts/check.sh, CI workflow, private Gitea repo, first push.

3. Settings model and storage

• T02 Settings with defaults and ranges; load (missing file, missing field, bad file, bad value) and atomic save; tests.

4. Themes

• T03 Built-in themes from upstream files; mapping onto Ely's Palette; dark-mode choice; tests.

5. Terminal engine

• T04 PTY: spawn through alacritty's event loop, OSC 7 tap on the reader, child id, events to the app; tests.
• T05 Shell integration for zsh, bash, fish, PowerShell, injected at launch; tests that zsh and bash report their folder.
• T06 Terminal view: frame from the grid, colors and styles, wide and combining cells, cursor shapes and blink, font, line height, padding, resize.
• T07 Box drawing, block elements and powerline shapes (U+E0B0–E0B7) painted as geometry; tests.
• T08 Keys: xterm encoding, cursor mode, Option as Alt, kitty keyboard protocol, IME; tests.
• T09 Mouse: selection, mouse reporting, wheel and scrollback, clipboard, copy on select, OSC 52, links; tests.
• T10 Focus reporting, title, silent bell, scrollback limit, find.

6. Main window and layout

• T11 ColumnShell with sessions, terminal and right columns; toggles kept in settings; window title; a transparent title bar over the window's background, as Ghostty's.

7. Sessions panel

• T12 Sessions: new, close, select, keys, titles and folders, ended programs, bell marks.

8. Right panel: Files

• T13 Git/Files switch; file tree of the session's folder with Git colors; open; reload on folder and prompt.

9. Right panel: Git

• T14 Git through the command line: status, branch, stage, unstage, commit, log, diff; tests on a temp repo.
• T15 Git panel: branch, changes, stage and unstage, commit, recent commits, diff view, errors.

10. Settings window

• T16 Settings window: categories, General rows, live apply and save.
• T17 Appearance: theme grids with previews, font, cursor with preview, opacity, blur, padding.
• T18 Terminal rows: scrollback, Option as Alt, copy on select.

11. Background blur

• T19 macOS and Windows: Blurred or Transparent or Opaque from settings, applied live.
• T20 Wayland: ext_background_effect_v1 on the window's surface.
• T21 X11: _KDE_NET_WM_BLUR_BEHIND_REGION on the window.

12. Menus and shortcuts

• T22 macOS menu bar; key bindings on all platforms.

13. Acceptance

• T23 End-to-end checks, README, acceptance table, CI green on three platforms.

14. Icon and the macOS app

• T24 Icon: Ely holding a terminal, on macOS's rounded square and alone for Windows and Linux; scripts/mac-app.sh builds ELYTerminal.app and its disk image.

15. Release

• T25 Windows zip with the icon in the executable, Linux tarball with the icon and a desktop entry, the app id on Linux windows, their scripts; release v0.1.0 on Gitea with the three builds.

16. Fixes from the owner's first run

• T26 On Windows every title bar control takes its press, Ely's window buttons too: in Ely, window buttons and header items occlude the drag region; the Git and Files switch moves below the title bar, centered; on Windows and Linux a gear in the title bar opens Settings; on Windows Ctrl-V pastes, as in Windows Terminal; the pointer over the terminal is the arrow; the settings window drops General, whose Shell and Start in lead Terminal, which lists every shortcut, and its categories and page scroll apart; the release's macOS disk image signed with Developer ID and notarized on the signing runner; release v0.1.1 with the three builds.

17. Omarchy

• T27 On Omarchy 4, an Omarchy theme wears the system's current theme and follows each switch, the default there; the v0.1.1 Linux tarball rebuilt with it, in place of the old one on the release.
• T28 Blur on Hyprland, which the owner found absent on Omarchy: Hyprland blurs behind a window only while its own decoration:blur:enabled is on, which Omarchy 4.0.4 turns off; the PRD, README, AGENTS.md, the acceptance table and the release notes say so, and how to turn it on.

18. herdr

• T29 Inside herdr the right column follows herdr's focused pane, which the owner found frozen: herdr keeps its panes' OSC 7, so on macOS and Linux ELYTerminal reads the folder from herdr's socket while herdr's client runs in the session's foreground.
• T30 The main window opens at the size it was left at, on macOS, Windows and Linux, which the owner asked for: the size is kept in the settings.
• T31 Release v0.1.2 with T29 and T30: version 0.1.2; the macOS disk image, the Windows zip and the Linux tarball, each from its script; the notes say it fixes herdr compatibility and keeps the window's size.
• T32 On Windows the right column follows herdr's focused pane too, which the owner found frozen there: ELYTerminal finds herdr's client under the session's shell, reads its arguments and variables, and asks herdr's named pipe.

19. Column widths

• T33 The sessions and right columns resize by a drag on their border toward the terminal, on macOS, Windows and Linux, which the owner asked for: in Ely, a ShellColumn resizable between a least and a greatest width; the two widths kept in the settings.

20. Prompts, program status and notifications

• T34 OSC 133 from the shell integration, which the owner asked for with everything below: zsh, bash, fish and PowerShell mark each prompt's start (A) and end (B), a command's start (C), and its end with the exit status (D); the tap reads any program's OSC 133; each session keeps its last command's status.
• T35 Jump to prompt: a prompt's first row is marked once the prompt is drawn; Cmd-Up and Cmd-Down, and Cmd-Shift-Up and Cmd-Shift-Down, on macOS, Ctrl-Shift-Up and Ctrl-Shift-Down elsewhere, scroll to the prompt before or after the view's top, as in Ghostty.
• T36 OSC 7501 program status, revision 0.4: reports checked as the spec checks them; records per terminal, by id, with clear and a cap of 256; a new prompt drops working, blocked and idle records, a full reset all; the support query answered with the states and kinds.
• T37 OSC 9;4 progress as the root record until an OSC 7501 report; OSC 9, 777 and 99 notifications read, OSC 99's chunks, base64, ids, occasions, actions, close and query included; ConEmu's other OSC 9 commands are no notifications.
• T38 Inside herdr, herdr's agent states from its snapshot are the session's records.
• T39 Session rows show the status: working with its progress, waiting by kind, done, error, a failed last command; hover shows each record's program, title and message; a hidden session that starts waiting marks its row.
• T40 System notifications on macOS, Windows and Linux through gpui's: a session that starts waiting, finishes or fails, and OSC 9, 777 and 99 requests, while the window is inactive or the session hidden, rate-limited; a press shows the window and the session.

21. Release

• T41 Release v0.1.3 with T32 to T40: version 0.1.3; the macOS disk image, the Windows zip and the Linux tarball, each from its script; the notes list what changed.

22. Status marks that move

• T42 The status marks move, which the owner asked for after aicss.dev's orbs: 3 by 3 dots in the state's color; work ripples, or fills by its progress, waiting dips, a settled state draws its shape, then holds; the window draws again only at the marks' steps while one moves.

23. Release

• T43 v0.1.3 rebuilt with T42, which the owner asked for in place of a v0.1.4: the version stays 0.1.3; the macOS disk image, the Windows zip and the Linux tarball, each from its script, replace the old ones on the release; the tag moves to their commit; the notes say what changed.

24. Keys, links and Ely

• T44 herdr's shortcuts work, which a user found dead: cmd+shift+ctrl+[ and ] on macOS, and the same keys as herdr reads them on Linux and Windows: under kitty's flags a key Shift makes a symbol of goes as its own key with Shift, the symbol its alternate, on macOS and Windows; on Windows keys go as win32-input-mode records, which ConPTY asks for and herdr reads; on Linux gpui keeps no key code, which the docs say.
• T45 Cmd-press on macOS, Ctrl-press on Windows and Linux opens the link under the pointer, which the owner asked for, wherever the terminal shows one.
• T46 Ely peeks over the main window's top edge from behind it, which the owner asked for after the 0.1.3 film, with several faces and moves; a switch in Settings, Terminal, turns her off.

25. Release

• T47 Release v0.1.4 with T44 to T46: version 0.1.4; the macOS disk image, the Windows zip and the Linux tarball, each from its script; the notes list what changed.