Projects

A project is a workspace within your organization where your team tracks work, builds workflows, and runs AI agents. Each project has its own Kanban board, backlog, statuses, metadata schema, and set of workflows.

Creating a project

1. From the organization home, select New Project.
2. Enter a project name and optional description.
3. Choose a starting status set, or leave the default to customize later.
4. Select Create. You will be taken to the project board.

Project settings

Open Project Settings from the project navigation to configure:

• General — Project name, description, and default branch for AI agent work
• Statuses — Add, rename, reorder, or remove statuses to match your team's process
• Metadata Schema — Define custom fields that appear on work items in this project
• Workflows — Create and manage workflow templates
• Repositories — Link git repositories to the project
• Action Buttons — Configure quick-action buttons for work items and the project board

Linking repositories

Repositories power AI agent workflows — agents need a linked repository to read code, commit changes, and open pull requests. You can link one or more repositories to a project. See Repositories for instructions.

Managing team members on a project

Project membership is separate from organization membership. An organization member must be explicitly added to a project to see it. Add members from Project Settings > Members.

Archiving a project

Archiving a project hides it from the active project list but preserves all data. Archived projects can be restored at any time from the organization settings. Archiving does not delete work items, workflows, or history.

Next steps

• Repositories — Connect git repositories to your project
• Work Item Types and Hierarchy — Understand epics, features, stories, tasks, and bugs
• Custom Statuses — Tailor your board to your team's process