Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

2.1 KB
Raw Blame
---
title: "Projects"
icon: "layer-group"
description: "Group tasks under a project with a description, assignees, and discussion."
---

A project groups [tasks](/product/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 <kbd>cmd</kbd>\+<kbd>f</kbd> 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](/product/agents) 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.