Organise Notes with Projects

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.
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 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 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.
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 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 detect the same project context when a Claude Code, Codex, Pi, or supported local Cursor session starts.

Projects are shared by all connected agents on your Keep account. They do not create a separate library for each agent.