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 from the sidebar.
  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.

The CLI detects the Git remote and current path when you create a Note inside a repository. You can also set the Project yourself:

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

Use --no-context if you do not want the CLI to detect the Git project.

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 uses the Git remote and current directory to rank matching Notes. The session hooks use the same project context when a Claude Code or Codex session starts.

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

HomeSign up free