Work with agents
Plan and Inbox
Sort tasks into Today, This week and Backlog, capture them in the Inbox, edit task pages, group by project and priority, and import tasks.
The Plan is your board of tasks, split into Today, This week and Backlog. Tasks without a place wait in the Inbox. Every task is a Zokie task, so its agent, chat and changes are one click away.
Open the Plan
Click Plan in the sidebar, or press ⌘1 from code view. Windows uses Ctrl in place of ⌘.
| Section | Meant for |
|---|---|
| Today | What you finish before you log off |
| This week | Committed for the next few days |
| Backlog | Sorted, not scheduled |
The header switches between List (sections stacked) and Kanban (sections side by side). Each task shows a tick button, its title, a dot for what its agent is doing, its project, priority, assignee and age.
Add, move and tick off tasks
- Add: click Add to today, Add to this week or Add to backlog, type a title and press Enter.
- Move: drag a task to another section, or onto Inbox, Today, This week or Backlog in the sidebar.
- Tick off: click the round button. The task stays in its section, struck through. Click again to reopen it.
- Clear completed archives every ticked-off task. The arrow beside it archives them on their own at End of day (the default), End of week or Never. The archived link opens the Archive.
A section on its own page
Click Today, This week or Backlog to open it on its own page. There you can:
- Search titles.
Escclears the search. - Switch views: Project groups tasks by project, Priority shows columns
P0toP3, List is a table you can sort. - Filter by Priority or Assignee. Clear drops the filters.
- Select tasks, or Select all, then use Move to, Project, Done or Delete in the bar at the foot.
Inbox
The Inbox holds your tasks with no project and no section yet. Type in Dump anything. A task, a thought, a link. and press Enter. Each row says where it came from: Quick add, From chat or Imported.
To sort a task out of the Inbox:
- Hover it and click a project chip. It moves to Backlog.
- Drag it onto a section in the sidebar.
- Tick several, then use the bar at the foot.
Delete asks first, then deletes the task and its chat for good. Its branches stay. To keep a finished task, tick it off instead. An empty Inbox reads Inbox zero. Everything has a place.
Task pages
Click a task to open its page, and press Esc to go back. In a task's chat, press ⌘I or click Task details to see the same details beside the chat.
| Property | Choices |
|---|---|
| Status | Inbox, Today, This week, Backlog, Done, Delete |
| Priority | P0 · Urgent, P1 · High, P2 · Normal (new tasks), P3 · Low |
| Assignee | You, a teammate on a shared board, or Unassigned |
| Deadline | Today, Tomorrow, Friday, Next week, or Clear |
| Project | A project, No project, or a new one typed into New project |
Click the title to rename it, up to 120 characters. More offers Start the agent, Stop the agent and Mark done. Share sets who can open the task's link.
- Description: the task's brief, so write what done looks like. Type
/to add headings, lists, to-dos, code, images, tables and more. It saves on its own, up to 20,000 characters. - Plans: a plan the agent writes opens as a tab beside Description. A plan saved as a file can be edited; a plan-mode plan is read-only.
- Checklist: the agent's to-do list as it works, with a count such as
3/7. You can read it, not edit it. - Comments: type in Add a comment… and press Enter.
Projects
A project is a short tag such as checkout, separate from the repositories a task works in. Set it on the task page, with a chip in the Inbox, or for many tasks at once from the bar at the foot.
To manage projects, open Settings › Projects. Click Add project, then click a project to rename it, add a description, pick a colour or set an icon (Emoji, Website or Upload). Renaming moves every task with it. Remove project shows only while no task uses it. On a team board, only owners and admins can change projects.
Import tasks
Click Import in the Plan or Inbox header. The Import tasks dialog has three tabs:
- Paste: a CSV, rows copied from a spreadsheet, or one task per line.
- Upload CSV: choose or drop a file up to 1 MB. Download the sample CSV shows the format.
- Ask an AI: click Copy prompt, send it to an AI that has Jira, Linear, Asana or GitHub connected, then paste its answer under Paste the answer.
Check the preview, then click Import. Nothing is made until you do, and you can import up to 500 tasks at a time. Only title is required. These columns are read, in any order:
title,description,priority,plan,due,project,labels,source,id,link
A task with no plan lands in the Inbox, or in Backlog if it has a project. Importing the same list twice adds no duplicates.
Other people's tasks
On a shared board, a teammate's task shows a dashed circle in place of the tick button. You can open it, but not move it, tick it off or change it. If nobody has started it, More › Start here makes it yours and starts its agent on your computer.