Apps

Mac

A launcher, not a file browser: one window, one column, no sidebar, no inspector. The search field is always focused — type to filter, or type something new and press ⏎ to add it. What you add lands in the filter you are on, with the same due date the iPhone's quick add would give it — today, unless the filter asks for another day.

⌃Space summons the panel over whatever you are doing and ⌃Space hides it again. It is a fixed 720×480 floating panel that always lands in the same place, opens cleared and focused, and does not dismiss when you click away — esc only clears the field. To move it, press and hold its background for a moment, then drag; it snaps to the middle of the screen, and ⌃Space brings it back to its place next time.

With the Delegate Listener on (Settings → Delegate Listener, off by default), the Mac also runs tasks you delegate to Claude Code or Codex, and shows it in the menu bar.

Settings on the Mac: Account (your plan, sign out, delete the account), Lists, Files, Filters, Agents, Delegate Listener, Usage Limits (once a Mac listens — see Usage limits), Keyboard Shortcuts, History and About (the version, updates, and what's new).

⌃Space is macOS's default "select previous input source" shortcut. If the panel does not appear, free it under System Settings → Keyboard → Keyboard Shortcuts → Input Sources.

Install and updates#

The Mac app is in open beta: download it, open the DMG and drag Cotask into Applications. It is signed with Apple's Developer ID and notarized, so it opens like any other app.

Cotask checks for a new build a few times a day and installs it when you quit. ⌘K → Check for Updates, Cotask → Check for Updates… in the menu bar and Settings → About check right away; About is also where automatic checks and automatic installs are switched off. Updates come through Sparkle: each one, and the list that announces it, is signed with Cotask's key and verified before anything installs.

Shortcuts#

KeysWhat
⌃SpaceShow / hide Cotask — from anywhere, over any app
⌘NClear the field and start a new task · ⌥⌘N show Cotask
⏎Add what you typed · accept a draft · open anything else
⇥Cycle Active → Backlog → All → each project (⇧⇥ reverses)
↑ ↓Move through the list
⌥↑ ⌥↓Move the selected task up or down inside its group
⌘⏎Toggle done
⇧⏎Complete, then write a note of completion — esc skips it, ⌘⏎ saves it. On a done task, add or edit its note
⌘KCommand palette
⌘PJump to a project
⇧⌘T · ⇧⌘I · ⇧⌘D · ⇧⌘B · ⇧⌘KMove to Todo · Doing · Draft · Backlog · Done
⌘1 ⌘2 ⌘3Active · Backlog · All
⌘FBack to the search field · esc clears it
⌘XDelete the selected task (⌘⌫ clears the search field)
⌘Z · ⇧⌘ZUndo · redo
⌘R · ⌘,Refresh · Settings

Every one of these is in the menu bar too, so nothing is hidden.

These are the defaults, and every one can be changed. Settings → Keyboard Shortcuts lists them all — with Previous category (⇧⇥) and Copy to prompt, which has none to begin with. Click a shortcut and press the new keys: esc cancels, ⌫ leaves the action without one. A keystroke another action already has moves over, and that action is left without one. A letter needs ⌘, ⌥ or ⌃, and ⏎ ↑ ↓ esc stay the list's own. The arrow beside a changed shortcut puts it back, and Restore Defaults resets them all. Shortcuts are kept per Mac.

The command palette#

⌘K acts on whatever is selected, and is also where projects are managed. It nests, and esc steps back out one level at a time rather than closing everything.

  • Task — accept a draft, complete or reopen, complete with a note, move to another status, reschedule to one of the usual days, set priority, set a repeat, pick the task it is blocked by, delegate to AI, add to or remove from a project, delete.
  • New project — type the name, pick a colour, ⏎ creates it.
  • Edit project — rename, recolour or delete. Deleting keeps its tasks.
  • Go to project — the same as ⌘P.
  • Refresh, Settings, Check for Updates — always at the end of the list.

The task card#

⏎ on a task opens a card over the list: title, notes (rendered; click to edit), attachments, status, project and due date. Add link or Attach file — or drop a link from the browser or a file from the Finder straight onto the card. esc closes it, ⌘⏎ completes the task from inside it.