Docs
kelve.aiGitHub

Your agent’s list

Everything you ask of your agent through kelve is one list it works through:

  • Reading what you opened.
  • An entry you opened before it was written.
  • A file read plainly.
  • Each note you leave it.

You can keep adding to the list while your agent works.

At the top of every page

Your agent’s dial and name are at the top of every page, with how much is left, such as “Claude Code 6”. The dial is part filled while your agent is working. Working means it called kelve in the last two minutes, or holds a job it took in the last ten. The dial is an empty ring when your agent isn’t working. While what’s open is read, it says how far, such as “Claude Code reading 3 of 17”. When your agent isn’t working, it says “3 of 17 read” instead. Click it for the list.

Once an entry you asked for is written, a count appears beside the dial, such as “3 ready”. Click it for Ready for you, with each entry a click away. An entry leaves the count once you’ve seen it.

The list

Your agent’s list opens beside the work, headed Claude Code’s list, with Working or Waiting.

SectionWhat’s in it
NowWhat your agent is doing, while it’s working
NextWhat it does after, in order, with Note for Claude Code at its foot
DoneThe way in and its pages, once they’re read, while the rest’s pages are written
Asked for in other thingsWhat you asked for in something other than what’s open, with where
Ready for youEntries you asked for that are written, until you’ve seen them
PausedThings you opened before, with files still to read

Each row says what kind it is in grey, Plainly, Entry or Note, then what it’s about. An idea’s entry is one row, however many jobs it takes.

Reading what’s open is a row for each thing being done, in this order:

  1. Reading the way in, or Reading its files when there’s no way in.
  2. Folder pages for the way in, the deepest first, or Pages for the change.
  3. Once the way in is read, Folder pages for the rest, the shallowest first.

In Now, each row says how far it’s got, such as “7 of 24”. Under it is what your agent has in hand, and what each subagent has, each with its dial filling as it goes. In Next, each row says how many are left.

Change the order

  • Do next: point at a row in Next, then Do next, to move it to the top.
  • Take off: point at a row, then Take off. Its work is put aside, and stays off, even if the work asks for it again. Only you put it back. An entry you took off says so, with Keep it for Claude Code to write. A note you take off becomes your own note, under Just you.

Something not written yet says where it is on the list, wherever it would be: “Next for Claude Code”, “2nd for Claude Code”, or “Claude Code reads 6 files before this”, with Do next.

When your agent is waiting for you

When nothing’s taking your agent’s list, the list says so at the top: “Waiting for you to ask Claude Code · 7 things to do”. kelve can’t see what your agent is doing. It sees only that nothing’s taking its list, so it says what to do. Copy what to say copies what to say for what this tab has open, by its number: “Do what’s waiting for you in kelve for “Calls to the bank that are safe to retry” (number 12).” Paste it to your agent, and it does that alone, even if you’ve opened something else since. With several tabs open, each copies its own, so you can have one agent work on each.

What counts as read

Your agent reads the way in first. It reads each part of the rest when you ask for it in In order. A file is read once its ideas are checked and it’s read plainly. If What kelve marks has it read as code, only its ideas are checked. Then each folder’s page is one more, deepest first. A change’s own page is the last. kelve counts the same way in three places: on the list, on each page waiting to be written, and when it tells your agent how much there is.

Paused

What you open last is what’s read. Open something else, and what was open joins Paused, as “paused just now”. Its reading waits, so an agent with only that left stops. What you asked for yourself in it moves to Asked for in other things, and is still done.

Paused is one line until you Show it. Then each thing shows how many files are left, with Take off and Open. Open goes back to it, and its reading carries on where it was. Asking your agent for one thing by its number also wakes it, for an hour.