# Your agent’s list

> What kelve asks of your agent, in order. Every page of kelve's docs is listed at https://kelve.ai/llms.txt.

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**.

| Section | What's in it |
|---|---|
| **Now** | What your agent is doing, while it's working |
| **Next** | What it does after, in order, with **Note for Claude Code** at its foot |
| **Done** | The way in and its pages, once they're read, while the rest's pages are written |
| **Asked for in other things** | What you asked for in something other than what's open, with where |
| **Ready for you** | Entries you asked for that are written, until you've seen them |
| **Paused** | Things 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](/docs/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.
