What kelve marks
You decide which ideas your agent looks for in your files, and which kelve marks for you, in one short note, marks.md. The note also says whether files open plainly or as code. It’s kept in your notes folder, and goes only to your own agent.
What it says
| Choice | What it does |
|---|---|
| Mark as if I’m | How much to mark overall: New, Learning, Working or Deep |
| Read files | Whether files open Plainly or As code, overall |
| By area | How well you know each area, such as rust, sql or distributed systems, and how its files read |
| Always mark | Ideas marked whatever else it says |
| Never mark | Ideas never marked |
| In your words | Anything else, in a sentence or two |
The levels:
- New marks every idea, the basics too.
- Learning marks all but the basics.
- Working marks advanced and specialist ideas.
- Deep marks specialist ideas only.
Until marks.md is written, kelve marks every idea but the basics, and files open plainly.
Change it
- In kelve: the key at the foot of the side, under Files or Notes, has What kelve marks. It opens the note beside the work. Change any choice in place, or leave a note for your agent to change it.
- In settings: Settings, What kelve marks.
- By asking your agent: “Write what kelve marks for me.” It reads the note, then writes it, from what it knows of you. The note says who wrote it last.
- In a terminal:
kelve marks set working, ornew,learningordeep. When your agent installs kelve, it chooses one of these for you. - By hand: it’s a plain Markdown file in your notes folder.
Open files as code
An area is a file’s when its name is the file’s language, such as rust, typescript, sql or markdown. If you’re new to Rust, its files open plainly. Files in what you know well open as code. Set this beside each area’s level, or for every file with Read files. The switch on a file changes it for that visit only.
What it changes
marks.md changes which ideas your agent looks for as it reads. It also changes which ideas kelve shows, in the squares, the margin and the ideas search lists. It doesn’t change what’s read. So what one person’s agent reads, others don’t read again.