---
title: "Keep Projects for notes, repositories, and agent context | Keep"
description: "Group Markdown notes and repository context in a Keep Project so connected AI agents can find the right project memory."
canonical: "https://keep.md/docs/projects"
language: "en"
---

# Organise Notes with Projects

Group Markdown notes and repository context in a Keep Project so connected AI agents can find the right project memory.

A Project connects related Notes and Git repositories. This helps Keep find the right decisions and handoffs when an agent works in a repository.

## Create a Project

1.  Open [Projects](https://app.keep.md/projects).
2.  Select **New project**.
3.  Enter a name.
4.  Add a description if the project needs one.
5.  Choose a colour.
6.  Choose the project state.
7.  Add one Git repository URL per line.
8.  Select **Save project**.

The available states are `active`, `paused`, and `completed`.

Repository URLs help Keep match work from the [CLI](https://keep.md/docs/cli) to the correct Project. Use the full remote URL, such as `https://github.com/iannuttall/seo`.

## Add a Note to a Project

1.  Open the Note.
2.  Open **Properties**.
3.  Select **Project**.
4.  Search for the Project.
5.  Select the Project name.

Enter a new name in the Project field if the Project does not exist. Select **Create** to create it and connect the Note.

New Notes from the CLI do not get a Project or Git metadata by default. Set the Project yourself, or add `--context` to detect the Git remote and current path from the repository:

```
keep notes create --title "Release handoff" --body-file handoff.md --project keep
keep notes create --title "Release handoff" --body-file handoff.md --context
```

## Review a Project

Open [Projects](https://app.keep.md/projects) and select a Project. The Project page shows:

-   its description and state
-   the number of connected Notes
-   the number of saved Items associated with it
-   its current Notes
-   its Git repository URLs

Select a Note to open it. Select a repository URL to open the repository.

Notes without a Project appear as **Personal** in places that show project context. Keep does not create a Project named Personal.

## Edit a Project

1.  Open the Project.
2.  Select **Edit**.
3.  Change the fields.
4.  Select **Save project**.

Changing a Project does not remove its Notes.

## Archive a Project

1.  Open [Projects](https://app.keep.md/projects).
2.  Open the actions menu for the Project.
3.  Select **Archive**.
4.  Confirm the action.

Archiving removes the Project from the active Projects list. Its Notes and saved Items stay in your library.

## Use Projects with agents

The [Keep CLI](https://keep.md/docs/cli) can rank Notes by Project when you ask for it. Pass `--project` to `keep search`, or use `keep context "<query>"` to detect the current repository first. The [session hooks](https://keep.md/docs/session-hooks) detect the same project context when a Claude Code, Codex, Pi, or supported local Cursor session starts.

Projects are shared by all [connected agents](https://keep.md/docs/agents) on your Keep account. They do not create a separate library for each agent.