# What kelve marks

> How much, by area, in your words. Every page of kelve's docs is listed at https://kelve.ai/llms.txt.

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`, or `new`, `learning` or `deep`. 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.
