create tasks for human

[danielehrhardt]

Agents can now give Daniel tasks when they get stuck on something only a human can do: a passkey, a CAPTCHA, a phone confirmation, a signature, a payment. The tasks land on a new My tasks board, and when Daniel closes one, the agent picks up where it left off in the same chat. It works end to end: core tests cover the full flow, and I clicked through the board in a sandbox instance.

How it works

• Agents get three new tools.
  • human_task_create takes a title, step-by-step instructions, an optional link and an urgency flag. The agent then ends its turn instead of polling for the answer.
  • human_tasks_list shows the agent its open tasks.
  • human_task_cancel takes a task back when the agent no longer needs it.
  • The agents' standing prompt, ticket brief and heartbeat now tell them to use these tools instead of only mentioning the blocker in their summary.
• When Daniel closes a task, either "Mark done" or "Can't do it", his note and any attached files go to the agent:
  • Chat idle: a new turn starts immediately, and the chat shows a small marker where it continued.
  • Agent busy in that chat: the message waits in the chat's queue and reaches the agent between steps.
  • "Can't do it": the agent is told to find another way or say plainly what stays undone.
• Board tasks (tickets) move to Blocked with "Waiting for you: H-3 …" while a task is open, and resume when Daniel closes it. They appear once in "Needs you", not also as a separate blocked ticket.
• Daniel can add his own tasks. Those just close; there's no agent to continue.
• Each chat can have at most 5 open tasks, and links must be http(s). If an agent's chat is deleted, its open tasks are withdrawn.

Desktop

• My tasks page (sidebar entry with a count badge, shortcut G M):
  • Three columns: To do, Doing, Done. Drag cards between them; dropping on Done opens the close form.
  • Cards show the task number (H-12), an Urgent flag, the link's domain, a preview of the steps, the agent and which chat or ticket it came from.
  • The detail panel has an "Open " button, the full instructions, "I'm on it", a note box with file attachments, "Can't do it" and "Mark done" (⌘↵).
• Elsewhere:
  • A "Waiting for you" bar with Open and Done buttons sits above the chat composer and on the ticket panel.
  • The rows also appear in Home's "Needs you" and the Inbox.
  • New tasks pop a notification with an Open action.

Tests

• 8 new core tests: creating a task through the real agent tool path, done and can't-do, the busy-chat queue, listing and taking back, the per-chat limit, chat deletion, the ticket blocking and resuming, and Daniel's own tasks over the API.
• Typecheck passes across shared, core, desktop, website and cloud. The mobile app isn't in that check, but it only reads the shared types and they stay compatible.
• Full core suite: 1603 pass, 4 fail. The same 4 fail on a clean main checkout. They depend on this machine's setup (Claude Code's auto-updater setting and home-folder layout), not on this change.
• main (including Let agents set a time to continue their work (GODM-29) #27 Projects) is merged into the branch. The only conflict was the migration list, now migration 77 (projects) followed by 78 (human tasks).

Not included

• No phone app screens yet; the phone is already allowed to list, move and close tasks over the API.
• No task delivery to Slack, Telegram or Teams.
• Tasks aren't linked to projects yet, and chats running on a remote runner don't show the board.

Screenshots are in /Users/danielehrhardt/.godmode/agents/godmode/workspace/task-28/:

• 01-my-tasks-board.png
• 02-task-sheet.png
• 03-closed-task.png
• 04-chat-waiting-bar.png
• 05-home-needs-you.png
• 06-ticket-sheet.png
• 07-urgent-sheet.png
• 08-after-mark-done.png

The desktop app needs the update script to show this. I noted the task in my memory.

---

Task #28 · done by Godmode with Godmode Bot