Docs
kelve.aiGitHub

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.

SettingWhat it does
kelve 0.3.0 is outShown 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 agentClaude 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 itThe one line that connects it, to copy
Let Claude Code pick up your notes, and lessonsAdds 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 entriesYour agent, with your model and plan. kelve has no model of its own

The shared graph

Signed out:

SettingWhat it does
Join the shared graphSign 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:

SettingWhat it does
Signed in asThe name you’re credited as, which the graph made up, with Sign out
What you’ve addedEntries, ways ideas relate, and times read by others
Sent todayEntries 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 termsRead them. When they’ve changed since you signed in, nothing is added until you Read and agree
Delete your accountThe 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 showsWhat it’s for
What Claude Code learnedEach lesson it wrote, waiting a day to leave, with Stop. After that, how the graph’s checks stand
Lessons Claude Code was givenEach, with what showed it held, or how far it’s confirmed

Lessons says how they work.

Reading

SettingChoices
ThemeLight, Dark, or Your system’s, the default. Kept in this browser
Code sizeSmall, Medium (the default) or Large
Text sizeSmall, Medium (the default) or Large, for entries, notes and text files
HighlightingFull (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 repoOn (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

SettingWhat it does
Choose a folderWhere your own notes are kept. kelve moves the ones you have
Show the folderOpens it in your file manager
Use kelve’s own folderKeeps them in kelve’s own folder again
A new note isJust 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.

SettingWhat it does
Share anonymous countsOnce 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 wrongEach short report kelve kept, which it sends nowhere. For each, See exactly what it says, Report it on GitHub, or forget it
Delete everythingYour 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