Settings
Settings is at the top right of every page, in seven sections. kelve keeps settings on your computer, in its own data folder. The theme is kept in your browser instead. What kelve marks is kept in your notes folder.
Your agent
First, which agents have connected, and when each last asked kelve for something.
| Setting | What it does |
|---|---|
| kelve 0.3.0 is out | Shown only when a newer kelve is out. It says what’s new and the version you have. It gives two ways to update, each to copy: “Update kelve”, to say to your agent, or kelve update |
| Your agent | Claude Code, Codex, Cursor, Gemini CLI or Another, with a dot by those installed. It’s named in what kelve says, and in the line that connects it |
| Connect it | The one line that connects it, to copy |
| Let Claude Code pick up your notes, and lessons | Adds or takes out kelve’s hook, for an agent that has hooks. It says if kelve’s hook is in other agents’ settings too |
| Who writes entries | Your agent, with your model and plan. kelve has no model of its own |
The shared graph
Signed out:
| Setting | What it does |
|---|---|
| Join the shared graph | Sign in with GitHub or Sign in with Google. Signing in is agreeing to the terms. From then on, what your agent writes and learns is added |
Signed in:
| Setting | What it does |
|---|---|
| Signed in as | The name you’re credited as, which the graph made up, with Sign out |
| What you’ve added | Entries, ways ideas relate, and times read by others |
| Sent today | Entries sent since midnight UTC, and how many were accepted, are being checked, or were turned away. Once today’s limit is reached, it says when the rest goes |
| The terms | Read them. When they’ve changed since you signed in, nothing is added until you Read and agree |
| Delete your account | The graph forgets your account. What others can read already stays, under your made-up name. It can’t be undone |
With KELVE_GRAPH_KEY set, it says Signed in with a key instead. Adding to the shared graph says more.
Lessons
| What it shows | What it’s for |
|---|---|
| What Claude Code learned | Each lesson it wrote, waiting a day to leave, with Stop. After that, how the graph’s checks stand |
| Lessons Claude Code was given | Each, with what showed it held, or how far it’s confirmed |
Lessons says how they work.
Reading
| Setting | Choices |
|---|---|
| Theme | Light, Dark, or Your system’s, the default. Kept in this browser |
| Code size | Small, Medium (the default) or Large |
| Text size | Small, Medium (the default) or Large, for entries, notes and text files |
| Highlighting | Full (the default), as an editor colours code. Quiet, only strings, constants, comments and the names of what’s defined. Or None |
| Keep what’s read in the repo | On (the default), kept in the project’s .kelve/read and committed with the work. Off, kept by kelve alone. Keep what’s read with the repo says more |
What kelve marks
Mark as if I’m, Read files, By area, Always mark, Never mark and In your words, then what to say to have your agent write it. They’re kept in marks.md, in your notes folder. What kelve marks has each one.
Notes
| Setting | What it does |
|---|---|
| Choose a folder | Where your own notes are kept. kelve moves the ones you have |
| Show the folder | Opens it in your file manager |
| Use kelve’s own folder | Keeps them in kelve’s own folder again |
| A new note is | Just you (the default), With the work, or For your agent, to start |
Notes with the work are always in the project’s .kelve/notes, and notes for your agent wait with your own. Notes says more.
What’s shared
Who gets what, in plain lines, with links to the privacy policy and the terms. What goes to the shared graph has it in full.
| Setting | What it does |
|---|---|
| Share anonymous counts | Once a week, numbers only: how many things you opened, entries you read, links you followed, notes you wrote, jobs your agent did, how lessons went, and kelve’s version, with a random ID. Off until you turn it on. See exactly what this week’s says so far shows it. DO_NOT_TRACK or KELVE_TELEMETRY=off stops it, whatever you choose |
| When something goes wrong | Each short report kelve kept, which it sends nowhere. For each, See exactly what it says, Report it on GitHub, or forget it |
| Delete everything | Your settings, what kelve keeps for what you’ve opened, and what’s kept for your agent. Your notes, and what’s read in each project, are your own files, and stay. It can’t be undone |