Projects
Group tasks under a project with a description, assignees, and discussion.
Starter documentation. Features and account details may differ from this deployment.
A project groups tasks. Each project has a status, priority, assignees, due date, a collaborative description, and a discussion thread.
Creating a project
Choose Project from the Create menu, or click New project in the Projects tab in Tasks. Enter a name and optional description, and set Status, Priority, Assignees, and Due date.
Projects are shared with your team by default. You can still keep one private: open Share and set Team access to No team access.
Projects tab
Open Tasks and select Projects. Press cmd+f to search. Group by status, priority, or assignee. Sort by updated or created date. Filter by status, priority, due date, or Assigned to me.
Right-click a project to rename, set status or priority, share, or delete it.
Project tabs
- Overview: properties, description, and discussion. The description supports
/commands and @mentions, and multiple people can edit it at once. - Tasks: the project's tasks as a list or board. New task creates a task in the project. Add existing tasks moves tasks into the project.
The side panel shows all project properties.
Adding tasks
Set a task's Project property from the pill under the task title, the Project column in the task list, or Add to project… in the right-click menu. Select multiple tasks to move them together.
A task belongs to one project. Adding it to another project moves it.
Deleting a project does not delete its tasks.
Agents
Assign an agent to a project and it starts a session for each task added to that project afterward. Tasks already in the project are not started. A coding agent can open a pull request from that session, and the task links to it.
Sharing
Project assignees get edit access. Share invites people, sets team access, and copies a link. Sharing a project to a channel posts a card that opens it.