Skip to main content
Projects is Desktop’s built-in task tracker. It’s shared between you and your agents: you create and organize work, and agents can create tasks, log progress as they go, and flag when they need your input. Open it from the sidebar — click Projects. The page header reads Manage Work.
Every agent can use Projects out of the box. There’s nothing to enable — the project tools are available to all agents automatically.

​
The five views

Tabs across the top of the Projects page switch between five views:
Everything that needs your attention, in two groups:
  • Waiting on you — an agent needs your input on a task before it can continue
  • New activity — a task assigned to you changed since you last looked at it
A badge on the Inbox tab shows how many items are waiting. Click an item to open the task — that also marks it as seen. When there’s nothing left, you’ll see “Inbox zero. Nothing needs you right now.”

​
Tasks

A task is a single piece of work. It has a title, an optional description (markdown works), a status, and an assignee. Tasks can live inside a project or stand alone. Every task gets a short key like GATEWAY-42 — the project’s key plus a number. Standalone tasks are numbered TASK-1, TASK-2, and so on.

​
Creating a task

1

Click New task

You’ll find the button in the All tasks view, or inside any project.
2

Give it a title

Add a description if you like — markdown is supported.
3

Pick a project

Choose a project from the dropdown, or leave it as No project / standalone. If you started from inside a project, this step is already done.
4

Click Create

The task appears immediately, with status Todo.

​
Statuses

Tasks move through six statuses: While a task is In Progress, it also carries a sub-status that tells you who the ball is with: To change a task’s status, open the task and use the dropdown in the top-right corner. Changes save instantly. On the Kanban board, just drag the card.

​
Inside a task

Click any task to open its detail page. You’ll see:
  • Description — the task’s write-up, rendered as markdown
  • Timeline — a running history of everything that happened: status changes, comments, subtasks created, and squad member activity. Squad member-run entries can be expanded to see exactly what happened
  • Comments — add a comment at the bottom of the timeline. Squad members can comment too; their comments are marked with 🤖. You can delete your own comments — a deleted comment shows as “deleted” in the timeline rather than vanishing, so the history stays complete
  • Details panel (right side) — assignee, sub-status, project, who created the task, linked chat sessions, and subtasks

​
Subtasks

Break a task into smaller steps with subtasks. In the details panel, type into the + Subtask field and press Enter. Each subtask is a full task of its own, with its own key, status, and timeline. Subtasks go one level deep: a task can have subtasks, but a subtask can’t have subtasks of its own.

​
Your Inbox

The Inbox is how Projects gets your attention. A task shows up there for one of two reasons:
  • Waiting on you — an agent set the task to Waiting on human. It’s asking for a decision, an answer, or a review before it can continue. The item stays in your Inbox until the task moves on — usually because you reply and the agent picks it back up.
  • New activity — a task assigned to you was updated since you last opened it. Clicking the item clears it.

​
Organizing with projects

Projects group related tasks — one per initiative, area, or goal. To create one, go to the Projects view and click New project. Give it a name and a short uppercase key (like GATEWAY). The key becomes the prefix for every task number in that project. Each project page shows a description you can edit (click Edit, write markdown, save), the project’s task list, and a New task button that creates tasks directly in that project. Projects have a status of their own — active, paused, completed, or cancelled.

​
How agents use Projects

Squad members don’t just appear in the timeline — they’re full participants. In any chat, you can ask a squad member to plan work, and it can:
  • Create projects and tasks — ask “break this feature down into tasks and track them” and the agent will set up the board for you. Tasks created by an agent are marked with 🤖
  • Update tasks as it works — a squad member picking up a task sets it to In Progress with sub-status Squad member working, and moves it along as it makes progress
  • Comment on progress — agents post markdown comments to the timeline, so the task page tells the whole story
  • Ask for your input — when an agent hits a question only you can answer, it sets the task to Waiting on human. The task lands in your Inbox
Every conversation that touches a task is recorded on the task as a linked session, so you can always trace which chats a piece of work came from. The full set of project tools available to agents is listed in the Tools reference.

​
Where your data lives

Tasks and projects are stored locally on your machine, in a database under the HQ’s data directory (data/projects.db). Nothing syncs to the cloud. Desktop picks up changes live — when an agent updates a task, you see it immediately.

​
What’s next

Desktop

The desktop app where Projects lives.

Chat with your agent

Start a conversation and put your agents to work.

Tools

Everything agents can do, including the project tools.

Squad

How agents are configured and how they work.