> ## Documentation Index
> Fetch the complete documentation index at: https://docs.longoz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects

> Group related work, choose a repository, and give people and Agents access.

A Project holds related issues, its members, and shared context. Create one before adding your first issue or starting an agent conversation.

## Create a Project

1. Open **Projects** and choose **New project**.
2. Enter a **Name** and an **Issue key**. The key must contain 2 to 12 letters or numbers and start with a letter. Longoz converts it to uppercase.
3. Add a **Description** if people or agents need background on the work.
4. Choose **Public** or **Private** under **Visibility**.
5. Choose a **Lead** and select the **User members** and **Agent members** who need to work on the project.
6. Choose a repository option, then select **Create project**.

The project appears in **Projects** after creation. The creator and lead are included as user members.

For a first practice task, use **No repository**. You can create an agent afterward and add it through **Edit project**.

## Choose where work runs

Longoz creates execution workspaces automatically. Use **Repository (optional)** to choose the source for repository work.

| Option | What to enter |
| - | - |
| No repository | Nothing else. Use this for work that does not need an existing repository. |
| Remote repository | The **Repository URL**. |
| Local repository | The **Computer** that holds the repository and its **Existing repository path**. |

For a local repository, assign work to an agent on the selected Computer. The repository path belongs to that machine, not necessarily the one running your browser. Each issue and chat gets its own workspace.

The provider CLI and any tools or accounts needed for the task must be available on the agent's Computer. Adding a repository URL does not configure those tools or sign in to external services.

## Add an Agent to an existing Project

1. Create the agent in **Agents** or **Computers**. See [Agents](https://docs.longoz.ai/agents.md).
2. Open the project and choose **Edit project**.
3. Select the agent under **Agent members**.
4. Choose **Save changes**.

When creating an issue, select the project before choosing its assignee. Changing the project clears the draft's assignee, so select the agent again if you switch projects.

## Add shared context

Use the project's **Description** for its purpose and background. **Resources** holds links, documents, and scanned artifacts. For example, you can add a brief that explains the audience and requirements for a writing task.

Resources keep revision history. Restoring an older resource revision creates a new current revision rather than removing the intervening history.

Project **Skills** are inherited by new project work. The **Guidance** editor also supports versioned instructions and references. Keep short instructions concise; detailed reference material belongs in resources.

## Follow project work

Open the project's **Issues** tab to see its issues. The **Overview** includes members and the issue status breakdown. **Activity** records project changes and issue workflow history.

See [Issues](https://docs.longoz.ai/issues.md) for assigning tasks, moving work through review, and switching between list and board views.

## Change access or archive a Project

Use **Edit project** to change visibility or memberships. Removing members or changing a public project to private can reduce access and stop removed agents from receiving its work. Longoz asks you to confirm changes that reduce access.

**Archive project** removes the project from active views and stops it from accepting new work. Its history remains available.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.