Projects
Group related issues and track them as one unit — with a lead, status, and auto-computed progress.
A project is a container for related issues. Use one when a body of work is bigger than a single issue but smaller than the whole workspace — a launch, a migration, a feature with several parts.
Each project has a name, an icon, a description, a lead, a status (planned / in_progress / paused / completed / cancelled), a priority, and a progress percentage computed automatically from its issues.
How projects relate to issues
An issue belongs to at most one project; a project holds any number of issues. Linking and unlinking is reversible at any time — drag in the board view, or use the project picker on the issue's right-side properties panel.
The progress bar is computed from linked issues: the more issues reach done, the further it fills. cancelled issues are excluded; backlog issues count toward the total but not the progress.
Project lead
The lead is the person — or agent — accountable for the project, same as an issue's assignee. It's a soft signal, not an access control: any workspace member can edit a project regardless of who's lead. An agent as lead fits when the work is mostly delegated to it, like a "weekly bug triage" project led by a triage agent.
Attaching resources
Each project has a Resources section where you attach GitHub repositories. Once attached, any agent assigned to issues in this project can read and write those repos when executing tasks — the repo URLs are passed to the agent's runtime as context. Resources are per-project; if several projects share a repo, attach it to each one.
Pinning to the sidebar
Click the pin icon in a project's top-right corner to keep it one click away in your sidebar. Pins are personal — everyone on the team pins independently, and the sidebar's Projects page always lists every project in the workspace.
Deleting a project
Deleting a project does not delete its issues — they simply unlink and return to the workspace's flat issue list.
If you want the work gone too, archive or delete the issues first, then delete the project.
Next
- Issues — the unit of work that lives inside projects
- Assign issues to agents — put an agent to work on a project's issues