Docs
kelve.aiGitHub

Notes

Leave a note on lines, on an idea, or as a page of its own. Who it’s for decides where it’s kept.

Who it’s for

NoteWho sees itWhere it’s kept
Just youYouYour notes folder, a folder for each project
With the workAnyone who opens the projectThe project’s .kelve/notes/, committed with it
For your agentYour agent, then youYour notes folder, until it’s done

Notes are plain Markdown files, so any notes app or editor opens them too.

Leave one

  • On lines: select them, then Note, or press N. Write it, choose who it’s for, then Keep. This works on a file, and on the code or text shown under a part read plainly.
  • On an idea: Add a note at the end of its entry. It shows wherever the idea turns up, in any project.
  • As a page: New note in the Notes tab, or Open as a page from a note. It opens beside the work. Type [[ and kelve finds ideas, files and lines as you type. Pick one and kelve links it. [[An idea]] and file.rs:28 become links.

A note on a page saves as you type.

Read them

A note shows under the lines it’s on. The Notes tab lists every note on what’s open: For your agent, With the work, then Just you. If a note’s lines changed since, it says so.

To delete a note, open it as a page, then Delete this note. It can’t be brought back.

Choose where they’re kept

Your notes are kept in kelve’s own folder until you choose one. In Settings, Notes, use Choose a folder. kelve moves the notes you have into it. Put them with your other notes, in an Obsidian vault for example. Use kelve’s own folder moves them back.

A new note is sets who a new note is for, to start.

Notes for your agent

A note for your agent goes on its list. Your agent picks it up the next time you message it. It does what the note asks in your files, then marks it done with a line on what it did. Leave notes for your agent has how.

None of your notes go to the shared graph.